PD, 

N 84 - 1 89 09 


Final Contract Report 


Prepared for 


George C. Marshall Space Flight Center 
Marshall Space Flight Center, Alabama 35812 


Intelligent Editor/Printer Enhancements 


Contract No. NAS8-34969 


Submitted by 


Arizona State University 
College of Engineering and Applied Sciences 
Computer Science Dept 

Tempe, Arizona 85287 

Principal Investigators: Marvin C. Woodfill 

Professor 
David C. Pheanis 
Assoc Professor 


September 15, 1983 


CR R 83005 


i / 


k 


Final Report 


Contract NAS8-34969 

ENHANCEMENT OF INTELLIGENT EDITOR/ PRINTER 

This report was prepaired by Arizona State University under 
contract NAS8-34969 Enhancement of Intelligent Editor/Printer for Marshall 
Space Fligh Center of the National Aernautics and Space Administration. 

The purpose of this contract was to develop for and furnish to the 
government for it's unrestricted use all microprocessor support hardware, 
software and cross assemblers relating to the Motorola 6800 and 6809 
processor systems. Furthermore, a printer controller and intelligent CRT 
(similar to the 6800 versions developed under NAS 8-32230) were to be 
developed using the 6809, third generation microprocessor. 

The following software was delivered and installed on a VAX 11-750 
system at MSFC 13 May 1983: 

1) The source program for the Motorola 6800/6909 assembler. 

2) The source program for the Motorola 68000 assembler. 

3) The source program of the Motorola Utility Debug 
(MUDBUG) package for the Motorola 6800. 

4) The source program of the Motorola Utility Debug 
(MUDBUG) package for the Motorola 6809. 

5) A documentation file for the MUDBUG system. 

6) The executable image for the Motorola 6800 assembler. 

7) The executable image for the Motorola 6809 assembler. 

8) The executable image for the Motorola 68000 assembler. 

9) The executable image for the ASU Compose (word proc) 
package. 

10) The command procedures developed at ASU to support the 

VMS VAX system. 

Appendix A of this report is a copy of the current User's manual 
for MUDBUG-2, the latest version of the M6800 Debug Package. Appendix B of 
this report is a copy of the design specifications for the MC6809 version 
of the intelligent printer controller card. MSFC is currently constructing 
a printed circuit card to implement this design. The software necessary to 
use this card as a controller for a Diablo Hy-Type 2 printer is currently 
under development and will be supplied to the government after it is 
checked out on the finished version of this card which is to be supplied to 
ASU by MSFC. Appendix C of this report is the design specification for a 
132 Character by 64 Line intelligent CRT display system using a Motorola 
6809 MPU. This version also has four pages of refresh memory. (A 68000 
version of this design is under development.) Appendix D of this report is 
a repo rt~ concerning~a feature that- is- currently being addedrd p-4fUI»UC-whinh'- 
will greatly increase it ease of use, especially for the in-frequent or 
casual user. This feature consists of a one-line, assembler and- dls—— 
assembler. This feature will, be added to the Memory .change-,, memory -dump, •_ 
and register display commands. Its use is documented -in this appendix- 
This capability has proved to be a significant aid because disallows an' 
engineer to debug in assembly language rather, than. machine language. 
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Conclusions: 

The hardware developed for this contract seens to work well in 
proto— type form. When the finished version of the printer card is 

supplied, the software will be verified and that software will be supplied 
to the government at no additional cost. Furthermore, the addition of the 
one-line assembler and dis-assembler to the debug package represents a 
significant improvement in the usefulness of the system to any user, but 
especially to those not intimately familiar with the machine language of 
the MPU. 

Recommendations: 

The impact of the one-line assembler/dis-assembler has been 
absolutely phenomenal. The amount of improvement that the one-line 
assembler/dis-assembler makes for a person who is developing and debugging 
assembly-language programs is so great that it far exceeds our initial 
expectations. Presently, the one-line assembler/dis-assembler for the 6800 
microprocessor is available only in preliminary form and is not fully 
integrated into MUDBUG, but the package is already tremendously useful. 

A one-line assembler/dis-assembler package for the 68000 
microprocessor is available commercially, but it is rather crude and 
inconvenient to use. We are confident that we could develop a much better 
package for the 68000, and we are also confident that we could develop a 
good one-line assembler/dis-assembler for the 6809 microprocessor. 

It is strongly recommended that the government fund a follow-on 
project to work on the development of one-line assembler/dis-assembler 
packages for the 6809 and 68000 microprocessors. The integration of such 
packages into the debuggers for the 6809 and the 68000 would represent a 
significant advance of the state of the art, and the result would be 
immediately useful to anyone who wants to develop and debug programs for 
those two modern microprocessors. 
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I have gone to a great deal of effort to make MUDBUG and this manual , 
as accurate and as usable as possible, but I have no doubt overlooked a few 
shortcomings. In the interest of quality, therefore, I am offering a 
reward of $1.00 in U.S. funds to the first finder of each error, whether it 
is technical, typographical, grammatical, or otherwise. I hope that this 
offer will convince people that I really do want to hear about my mistakes 
so I can correct them. Students in my class who use MUDBUG and thi 3 manual 
may elect to receive 20 points of class credit in lieu of a cash reward. 

I shall appreciate receiving positive suggestions for improving this 
manual or the MUDBUG system in any way. Sane of the features that are 
already implemented in MUDBUG evolved from discussions with M6800 users, 
and future suggestions for improvements will be more than welcome. 


DCP 


(c) Copyright 1978, 1979, 1982, 


1983 by David C* Pheanis 


All rights reserved* 


First Printing: August, 1983 
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Chapter 1 


Introduction 


MUDBUG is a general-purpose Monitor-Btility-DeBUG software package for 
a Motorola M6800 microprocessor. The first version of MUDBUG, which was 
known as MUDBUG-1, was designed and developed at Arizona State University 
in 1975 by Dr. Marvin C. Woodf ill and Ms. Mary L. Dryden to replace the 
Motorola-supplied MAID and MHBUG systems, both of which were deficient in 
several respects. In the s umm er of 1976 Hr. Don E. Smoker converted MUDBUG 
from its original hand-written machine-language form into a machine- 
readable assembly-language file, and then in 1977 the MUDBUG system was 
almost completely redesigned and rewritten by Dr. David C. Pheanis with the 
help of some background information from Dr. Woodf ill. 

Until 1982 MUDBUG existed as a 1-K program capable of running in a 1-K 
EPROM such as a 2708. Falling memory prices and rising chip capacities 
eventually modified the marketplace to the extent that 2-K EPROMs such as 
the 2716 were actually cheaper than 1-K 2708 EPROMs. In 1982, therefore. 
Dr. Pheanis started using a 2-K 2716 EPROM and modified MUDBUG by adding 
several enhancements that had not been possible when the program had been 
restricted to a 1-K EPROM. 

Anyone who has any suggestions, comments, or questions regarding 
MUDBUG should contact: 

Dr. David C. Pheanis 
6822 S. Butte Avenue 
Tempe, Arizona 85283 
(602) 839-5229 

AI 30 , in the unfortunate event that anyone ever detects any error in 
MUDBUG, the author would appreciate receiving a detailed report of the 
suspected error and its symptoms. Finally, the author will appreciate 
receiving any well-conceived ideas for useful features that could be 
included in the next release of MUDBUG. 


In its present form MUDBUG requires 2-K (i.e., 2,048) word3 of ROM 
program space in locations $F800 through $FFFF. (Note: A leading is a 
standard M6800 notation that indicates a hexadecimal number. A decimal 
number i 3 normally indicated by the absence of a leading and an octal 
number is Indicated by a leading zero. A binary number is indicated by a 
leading lt J n character.) In the rest of this document we'll use the label 
ROM to refer symbolically to the first location of the MUDBUG ROM. 

—--^rrBeside 3 requiring a- 2-^ r -block of ROM, MUDBUG al so-requlres^-a- 128-word-- 
block of RAM for its stack and internal variables. This block of RAM„can-„- 
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atart at any convenient location, and Its starting location is indicated by 
the label HAM, which is defined by an equate near the beginning of MODBUG. 

Locations RAM+$40 through RAM*$7F of the MtJDBOG RAM area are currently 
reserved for use by the user's programs, and, in particular, the user's 
default stack grows downward from location RAM+$7F toward location RAM+$40 * 

Besides using ROM and RAM, MUDBOG also needs an ACIA for RS-232 
communications with the user's terminal. The memory location of the ACIA' 3 
control register is indicated by the label ACONT, and the location of the 
ACIA's data register is indicated by the label ADATA. Both of these labels 
are defined by equates near the beginning of MtJDBOG, so they can be 
modified easily to fit various hardware configurations. 


Chapter 2 


Interrupt Vectors 


MUDBUG is designed such that the last eight locations of its ROM space 
function as the interrupt vectors for the microprocessor system, and the 
interrupt vectors are set up in the MUDBUG ROM to make the M68GG interrupts 
function as follows: 


Hardware Interrupt (IRQ): Branch indirectly through locations RAM and 

RAM+1. (Note: The label RAM is used 
throughout this document to designate the 
first location of the MUDBUG RAM area. ) 


Software Interrupt (SWI): Branch indirectly through locations RAM+2 

and RAM+3 - 

Nonmaskable Interrupt (NMI) : Branch indirectly through locations RAM+4 

and RAM+5. 


Restart Interrupt 


(RSI): Initialize or restart the MUDBUG system as 

if a power-up condition had occurred. 


Locations RAM and RAM+1 , RAM+2 and RAM+3 » and RAM+4 and RAM+5 are 
automatically set up at MUDBUG- initialization time so that a hardware 
interrupt (IRQ), a software interrupt (SWI), or a nonmaskable interrupt 
(NMI) invokes a routine that prints the contents of all of the registers 
and returns control to the top of the MUDBUG command-decoding routine. 

For purposes of flexibility, the indirect ihterrupt-vector pointer 
values in the first six locations of the MUDBUG RAM can be modified quite 
easily via the MUDBUG memory-change (i.e., "C") command to allow the user 
to capture the various interrupts and to service them via his or her own 
specialized interrupt-handling routines if necessary* MUDBUG' s memory- 
change command is explained in detail later. 

Users who capture the interrupts for their own interrupt-handling 
routines should carefully note the fact that the values of the XR and the 
CC register are not preserved in the registers upon entry to a user-defined 
interrupt handler because MUDBUG loads the ZR with the appropriate indirect 
interrupt vector to route control to the user-defined interrupt-handling 
routine. Loading the XR, of course, modifies some of the bit3 in the CC 
register. The original values of all of the registers (including the ZR 
and the CC register) are always preserved on the stack, so they are readily 
recoverable by any interrupt-handling routine . that ever_.needs_.them. 
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Chapter 3 


MUDBUG Otilitie3 


Whenever control '■comes to the top of MUDBUG (i.e., followin g system 
initialization, upon the completion of a MUDBUG command, at the termination 
of a user’s program, etc.), the system outputs a prompt (us ual 17 a but 
sometimes a "?") on a new line and waits for an input character. The user 
can then activate a MUDBUG utility routine by typing a co mman d mnemonic 
followed by the appropriate parameter(s) (if any) for the selected command. 
MUDBUG command mnemonics currently consist of only one or two characters 
each, so the user can type them quickly and easily. 

When MUDBUG receives a valid command mnemonic in response to a prompt, 
it outputs a single blank space to the terminal to 3how that it recognizes 
the command. Then it reads the parameter(s) (if any) that are required for 
the given command. If MUDBUG receives an invalid command mnemonic in 
response to a prompt, it outputs a backslash ("V*) and a bell to reject the 
bad input, and then the system prompts the user again for a good MUDBUG 
command mnemonic. 

Individual MUDBUG commands require from as few as zero to as many as 
four parameters, and the parameters are known as START, STOP, KEY, and 
MASK, respectively. The values of the parameters are input following a 
command mnemonic a3 hex-number inputs, which are described below. 

A hex-number input may be 3igned or unsigned, and it i3 terminated by 
a comma, a blank space, a tab, an asterisk, a period, a solidus ("/"), or a 
carriage return. We'll frequently use the notation n <CH>'' in this document 
when we wish to emphasize the presence of a carriage return. At other 
times, we'll simply assume the presence of a carriage return at the end of 
an input line. 

A solidus termination character has a rather special global meaning in 
that it immediately aborts the MUDBUG command that is currently being 
typed. A solidus is therefore useful as an abort character, and a user can 
easily abort any MUDBUG command line by simply typing a solidus before the 
input line has been completed. 

A carriage-return terminator also has a rather special global meaning 
in that it always terminates the command that is being typed. If the user 
types a carriage return before all of the command's parameter(s) have been 
typed, MUDBUG simply uses default values for the remaining parameter(s) . 

The period, comma, space, tab, and asterisk terminators don't have any 
special.. meanings, except as noted for certain individual MUDBUG. — commands. 
Most users -'use -the- comma orspacer.terminator to- termi nate-each parameter 
except the last parameter for a command, and they typically . use . a_ carriage 
return to terminate a command's last parameter. - For lexample^rartypical: 
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command might be typed as "F 100, 200, 23, FF<CR>" where the <CR> 
terminator is used to terminate the command* 3 last parameter. Similarly, a 
user might type "F 100 200 23 FF<CR>" to perform the same operation. 

A hex-number input to M0DB0G is always typed without a leading 
because a leading would be redundant in view of the fact that MDDBOG 
automatically assumes that. all input numbers are hexadecimal by default. 

MIJDB0G allows the user to type leading blank 3pace(s) and/or leading 
tab(s) with a hex-number input because many users like to ins ert white 
space at the beginning of an input number for improved readability. No 
leading white space is required, of course, but blanks and tab3 are allowed 
until the first hextet of the input number has been typed. Since MUDBUG 
allows the user to type leading blanks and/or leading tab3, a user can't 
use a blank or a tab to terminate an empty (i.e., missing) input number. A 
user who wants to omit an input number entirely must type one of the other 
termination characters to indicate the missing number. For example, a user 
could type "I 100, , 0<CR>" to obtain a default value for the second input 
parameter, but a user could not use a blank or a tab to terminate the 
missing second parameter. 

Since a blank space or a tab can* t be used to terminate a missing 
input number, we refer to the blank space and the tab as soft termination 
characters. The other termination characters (asterisk, comma, period, 
solidus ("V), and <CR>) are all known as hard termination characters 
because they can be used to terminate any input number including a missing 
input number. 

A leading minus sign negates a hex-number input value, and a leading 
plus sign has no effect on the value of a hex-number input. Two minus 
signs (or any even number of minus signs for that matter) cancel each 
other, so a user can conveniently change his or her mind after typing a 
minus sign by mistake. Any odd number of minus signs, of course, results 
in the negation of the hex-number input value. Leading sign characters are 
permitted until the first hextet of the input number has been typed, and 
after that time sign characters are rejected (see below). 

A user who makes a mistake when typing an input number can quickly 
correct the error by simply typing enough hextets to shift the mistake out 
of the left end of the number. For example, "1241234" is equivalent to 
"1234" as a four-hextet input number, and "-1202" is equivalent to "-02" or 
just "-2" as a two-hextet input number. Similarly, "-1000F" is equivalent 
to "-F" as an input number. 

A user can also correct a typing error in a hex-number input by typing 
a backslash ("\") before the number's termination character has been typed. 
A backslash deletes all previous input characters for a number, so a user 
-■ nan, easily restart, an input -number- -from- its f ir st- charaet erv:* -For: example , 
" — 127\-3D75\-\3C51" is equivalent to "3C51" as a hex-number input,, and 
"5ADDD\ — 5ADD" is equivalent to "-5 ADD" as a— hex-nUmber input.. Notice 
that the backslash correction feature can be used a 3 - many.; times i- as desired 
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in a single input number, and also notice that a backslash deletes all 
previous input characters for the number, including sign characters. 

If MDDBOG receives an invalid input character when it thinks it should 
be reading a hexadecimal number, the system outputs a bell and a question 
mark to the terminal to alert the operator to the fact that the bad input 
character is being rejected. The invalid input character is effectively 
ignored, and MDDBOG reads the next input character as the next character of 
the hexadecimal input number. Only the following ASCII characters are 
valid for hex-number inputs: 

blank tab + - 0 1 2 3 ‘l 5 6 I 8 9 A B C D E F a b c d e f \ . , * / <CR> 

The first two characters in this list (blank and tab) are valid as 
leading characters before the first hextet of the input number has been 
typed, and they are also valid as termination characters after the first 
hextet of the input number has been typed. The next two characters in the 
list (+ and -) are valid only before the first hextet of the input number 
has been typed, and they are rejected as invalid inputs if they are ever 
typed anywhere other than at the beginning of a number. A backslash ("\") 
can always be used to restart am input number, so a user can go back and 
type a forgotten sign character by first typing a backslash. Notice that 
lower-case alphabetic hextets (a-f) are accepted as being equivalent to the 
corresponding upper-case alphabetic hextets (A-F), 30 users don't need to 
worry about pressing or not pressing the shift key when talking to MDDBOG. 

MUDBUG always r members the values of the START, STOP, KEY, and MASK 
parameters from one command to the next, so a user can conveniently specify 
the previously-existing value of a parameter by typing only a hard 
termination character (in this case, a comma, period, asterisk, or <CR>) 
for that parameter. For example, if the last value that was used for the 
START parameter was $89AB, then simply typing "C.™ is equivalent to typing 
"C 89AB." This feature reduces the number of characters that the user must 
type, so it helps prevent mistakes that are caused by simple typing errors. 
Additionally, it alleviates frustration because the user doesn't need to 
retype the same input number over and over. 

Recall that a user can specify default values for the rem a i ni ng 
parameter(3) on a command line by typing a carriage return to terminate the 
command. For example, a user might want to type new values for the first 
two parameters and then use a carriage return to specify the default values 
for the command's remaining parameters. 

MDDBOG maintains a complete set of pseudo-register values, and the 
user can easily inspect and/or change these pseudo-register values via the 
MDDBOG register- change commands, which are explained in detail later. The 
user can also inspect and/or ch ang e individual memory locations, and one 
can initialize memory in blocks, load object modules_into, memory, . .compare 
object modules to memory, write object modules- from-memory-ta: a^-tape> -dump- 
memory to the terminal in a readable format, search - me mory, _.,to :_find. . any, 
specified, values, and/or execute any program. MDDBOG conveniently .performs 
self-relative addressing calculations for- the user,- and, MDDBOG. also does 
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hexadecimal addition and subtraction for the user. Interactive debugging 
is quick and easy because the user can tell MUDBUG to trap control at any 
specified point in his or her program. Finally, if the hardware of the 
user's system supports step-mode operations, the user can tell MUDBUG to 
execute a single instruction or a specified number of instructions. 

The table on the following page, which is intended to be used as a 
handy reference sheet, briefly summarizes all of the MUDBOG commands, and 
the pages that follow the command-summary table describe the individual 
MUDBUG commands in sufficient detail to serve as a programmer's manual. 
The table provides a brief functional description of each command, and the 
table also includes a number with each command to tell how many parameters 
the command requires. 

Upper-case command mnemonics (e.g. , A, B, and C) are used throughout 
this document in all descriptions and examples, but MUDBUG also accepts 
lower-case command mnemonics (e.g., a, b, or c) as being equivalent to the 
corresponding upper-case command mnemonics. Therefore, users can always 
type MUDBUG commands with either upper-case or lower-case alphabetic 
characters, whichever happens to be more convenient. 
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3.1. MODBOG Command S ummar y. 


Parameters: START, STOP, KEY, and MASK. 

Pseudo Registers: AR, BR, XR, PH, SP, and CC (H I H Z 7 C). 


Command Mnemonic 
Number of Parameters 
Description of Command's Function 
* 0 An asterisk introduces a comment line. 

A 0 Print the AR value in hex, and accept a new hex AR value. 

B 0 Print the BR value in hex, and accept a new hex BR value. 

C 1 Change (after printing) the contents of memory location START. 

E 0 Establish a new CC value after printing the existing CC value. 

F 4 Find KEY under the bits of MASK in locations START through STOP. 

G 1 Go to location START to execute the user's program. 

H 0 Halt return. Go to the location that is addressed by the PR. 

I 3 Initialize locations START through STOP to the value KEY. 

K 2 Kalculator. Set START < — START +• STOP, and print START. 

L 1 Load (.) or compare (,) an object module to memory; Di3p r START. 

M 3 Memory dump of locations START through STOP to the terminal. 

N IAN step. Execute START instructions beginning at location PR. 

0 1 A One step. Execute one instruction at START. Default START = PR. 

PE 1 Peek at memory. Like C except that it never writes to memory. 

PO 1 Poke into memory. Like C except that it never reads from memory. 
PR 0 Print the PR value in hex, and accept a new hex PR value. 

Q 0 Query the registers. Print AR, BR, XR, PH, SP, HINZVC. 

R 1 Relative address: Print and/or set the destination of a branch. 

S 0 Print the SP value in hex, and accept a new hex SP value. 

T 4 # Trap. Go to START; trap control when it reaches STOP KEY times. 

V 4 A Verify ROM Program. Like "T" except that it can be used in ROM. 

W 2 Write locations START through STOP to tape in object format. 

X 0 Print the XR value in hex, and accept a new hex XR value. 

Z 0 Zero the AR, BR, XR, PR, and CC, and initialize the SP. 



A Commands that are marked with an "A" are available only if the system on 
which MUDBUG is running has the necessary hardware to support step-mode 
operations. 

# Only the first two parameters of the "T" command are available if the 
system on which MUDBOG is running doesn' t have the necessary hardware to 
support: step-mode operations. . _ x=32~^zz-z,j^^r2- nrp: 
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3-2. MUDBUG Command Descriptions. 

This section contains user-oriented descriptions of all of the MUDBUG 
co mman ds. The descriptions are alphabetized by the command mnemonics for 
the convenience of the reader. 


Command ; No Parameters; Comment. 

The command , which has no parameters, is used to introduce a 
comment line into the transcript of the user's session at the terminal. If 
the user inputs an asterisk in response to the prompt ( B > n or B ? n ) for a 
MODBUG command mnemonic, MUDBOG reads and echoes (but otherwise ignores) 
all subsequent input characters (including solidus characters) until a 
carriage return is input. Users can therefore annotate and document the 
listings of their MUDBUG transactions by typing any desired comments on 
lines that begin with asterisks. Also, the comment facility effectively 
turns the user's MUDBUG transcript into a handy scratchpad for recording 
ideas and problems as they occur (before they are forgotten). 

The use of an asterisk to introduce a comment line in MUDBUG is 
compatible with the definition of a comment line in the M6800 assembly 
language, so MUDBUG comment lines should seem quite natural to most users. 


"A" Command; No Parameters; Change AR. 

The "A" command, which has no parameters, displays the current hex 
value of the pseudo AH, and then it accepts a new hex value for the AR. If 
a user types a hard termination character (/ * , .or <CH>) alone without a 
number for a new AR value, the pseudo AR retains its present value. 


"B" Command; No Parameters; Change BR. 

The "0" command , which has no parameters, displays the current hex 
value of the pseudo BR, and then it accepts a new hex value for the BR. If 
a user type3 a hard termination character (/ * , .or <CR>) alone without a 
number for a new BR value, the pseudo BR retains its present value. 


"C Command; 1 Parameter; Change Memory. 


The - "C” -command, which has one. parameter, displays the^addres avan d v -the^ . 
current hex value of the contents of memory location-START," and then it 
accepts a new hexvalue to be put'into that location. — — — T'”"'. 
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If the new hexadecimal value for location START la terminated by a 
carriage return, MUDBUG automatically continues the "C* command by setting 
START < — START + 1 and performing the "C B command’s function for the next 
location in memory. If an asterisk, blank, or tab termination character is 
used to terminate the new hexadecimal value for location START, MUDBUG sets 
START < — START - 1 and automatically performs the "C* command with the 
preceding memory location. If a comma terminator is used to terminate the 
new hex value for location START, MUDBDG performs the "C” command’s 
function again with the same location. If the new hex value is terminated 
by a period, the "C" co mman d returns control to the top of MUDBDG after it 
installs the new value into memory. Finally, if a solidus (’’/”) terminator 
is used, the "C" commaind is aborted and control returns at once to the top 
of MUDBDG with no change to the contents of location START. 

If a user types a hard termination character (/ * , .or <CR>) alone 
without a number for a new memory value, the contents of the memory 
location remain unchanged, but the function of the termination character 
regarding the continuation or termination of the "C” command is 3till 
effective. Users can therefore examine several consecutive memory 
locations rather conveniently by using carriage-return or asterisk 
terminators, and they need to type new values only when new values are 
actually desired. 

The "C" command reads back and verfies the value that it stores into 
memory, so any attempt to use the "C" command to alter a value in ROM or in 
nonexistent memory is automatically aborted with a backslash and a bell. 
This feature is included so the user won't think a value is changed when it 
is, in fact, not changed. 

The "C” command Is not intended for use with read-only or write-only 
registers such as the status and control registers of an ACIA. A user who 
wishes to examine a read-only register should use the "PE” (peek) command, 
and a user who wishes to put a value into a write-only register should use 
the "PO" (poke) command. 


"E" Command; No Parameters; Establish a CC Value. 

The "E" command, which has no parameters, is used to establish a value 
for the pseudo CC (condition-code) register. The "E" command displays the 
current eight-bit hexadecimal value of the condition-code register, and 
then it accepts a new hexadecimal value for the pseudo CC register. 

Notice carefully that the pseudo CC register contains eight bits. The 
top (i.e. , leftmost) two bits are essentially meaningless and will always 
be set following the execution of any portion of any user’s program because 
-the. M68Q 0 hardw are always sets — these-- two condi tion-code_bit3. We refer to. 
the other" six- condition-code : bit3~( from left to right 1 a3 -H,~-I^- N , _ Z , — T'rr 
and-. C r and they are generally- quite -important-- for---purpose3 -of - debugging 
programs. . The condition codes are interpreted a3~ follows : — — ; 
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H = half carry I = interrupt mask N = negative 
Z = zero V = overflow C = carry/borrow 

If a user types a hard termination character (/ * , .or <CR>) alone 
without a new value for the CC register, the pseudo CC register retains its 
present value. 


"F" Command; 4 Parameters; Find Memory Values. 

The "F ff co mman d requires all four parameters, and it is used for 
finding specified kinds of values in a specified area of memory. 

If the MASK parameter is nonzero, the "F" command searches memory 
locations START through STOP to find any words that contain the value KEY 
when considering only the bit(s) that are set in MASK. MODBUG displays 
both the memory address and the contents of each, word that is a match. 
When the MASK parameter is nonzero, therefore, the MUDBUG "F" command finds 
and lists all words from location START through location STOP such that 
[(WORD) .and. MASK] = [KEY .and. MASK]. To find words that exactly equal 
KEY, of course, a user should specify a MASK value of $FF (i.e., -1). 

If the MASK parameter Is zero, the "F n command searches memory 
locations START through STOP for any words that do not contain exactly the 
value KEY. MUDBOG displays both the memory address and the contents of 
each, such word that is found. 


"G n Command; 1 Parameter; Go to START. 

The "G" command, which has one parameter, is used to transfer control 
to the user's program. The "G" command sets the pseudo PR equal to START. 
Then it loads the M6800 hardware registers from the software-defined pseudo 
registers and transfers control to location START to execute the user's 
program. 

MODBOG temporarily treats the W G" command as an illegal command when 
the pseudo stack pointer ha3 been set to address ROM or nonexistent memory. 
This feature protects the user from inadvertently transferring control to 
his or her program with an invalid value in the stack pointer. Please 
refer to the discussion of the "S" command for details. 


"H" Command; No Parameters; Halt Return. 

The "H" command,- which- i3 : - known as the halt— return -command;— has-no— 
parameters. It loads the M68Q0 hardware - registers — frcaa~ -the:__p3eudp„ 
registers, and then it transfers control to the locatioo^that is --designated: 
by the pseudo PR. - " "* , s . . zr.-: _ . 
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The pseudo PR normally points to the memory location immediately 
following the location from which, the last halt (i.e. f SWI) was executed, 
but the user can, of course, change the pseudo PH by using the "PR" 
command, which is described elsewhere in this chapter. 

The "H" command is convenient for executing a user's program in 
segments where the end of each segment is marked by the occurrence of an 
SWI instruction. The "H" command is also useful for returning control to a 
program that has been interrupted by a nonmaskable interrupt (NMI). A user 
who suspects that his or her program is lost in an Infinite loop can 
generate a nonmaskable interrupt (usually by pressing a button marked NMI), 
and this action normally halts the program and dumps the registers to the 
terminal just as if an SWI instruction had been executed. If the user then 
decides to continue the execution of his or her program, an n H n command 
conveniently and automatically returns control to the precise point of the 
interruption just as if no interruption had occurred. 

The NMI interrupt and MtTDBDG * s "H" command can be used together as 
described above to monitor the progress of a program that has a very long 
execution time. 

MNDBOG temporarily treats the Tr H n command as an illegal command when 
the pseudo stack pointer has been set to address ROM or nonexistent memory. 
This feature protects the user from inadvertently transf erring control to 
his or her program with an invalid value in the stack pointer. Please 
refer to the discussion of the "S" command for details. 


"I" Command; 3 Parameters; Initialize Memory. 

The "I" command requires three parameters, and it initializes memory 
locations START through STOP (inclusive) to contain the value KET. MUDBOG 
automatically aborts any attempt to use the "I" command to alter any ROM or 
nonexistent memory locations, and the system notifies the user of the error 
by outputting a backslash and a bell to the terminal . All RAM locations 
that were initialized before the ROM or nonexistent memory location was 
encountered remain initialized just as requested, so part of the command's 
function may be performed successfully even in the event of am error. 

The "I" command is useful for backgrounding memory areas with desired 
values, and it can also be used to initialize tables and data areas. 
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"K" Command; 2 Parameters; "Calculator" Utility. 

The "K" command, which requires two parameters, i3 convenient for 
performing 16-bit two' s-complement hexadecimal additions and subtractions. 
The "K" command sets START < — START + STOP, and then it prints the 
updated 16-bit value of START in hexadecimal. Notice that MUDBUG puts the 
sum into the START parameter to facilitate 3ubtotaling operations via 
several consecutive executions of the "K" command. For example, the 
following "K" commands could be used to compute the sum of $2A12, $21, 
-$B4C, $591 A, and -$1F2£: 


K 2A12, 21. 
E , -B4C. 

K , 591 A. 

K , -1F2E. 


The "K" command is also useful for finding the 16-bit two’s complement 
of a hexadecimal number. To find the two’s complement of a value, one can 
simply use the "K" command to subtract the value from zero. For example, 
to find the two’s complement of $B7C, a user could type either "K 0, -B7C” 
or "K -B7C, 0." Similarly, to find the two’ s-complement representation of 
-$1A8, one could type "K -1A8, 0" or "K 0, -1A8." 

In another application, the "K" command can be used to find the 1 6-bit 
one’s complement of a hexadecimal number. The one’s complement of a number 
is just its two’s complement minus one, so subtracting a number from minus 
one yields the one’s complement of the number. For example," a user could 
find the one’s complement of $DA9 by typing "K -1, -DA9" or "K -DA9, -1." 
Similarly, one could type "K -1, -B5C* or "K -B5C, -1 n to find the one’s- 
complement representation of -$B5C. 


"L" Command; 1 Parameter; Load/Compare. 


The "L" command , which requires one parameter, loads or compares an 
M6800 object tape to memory. MUDBUG takes the value of the START parameter 
as a 1 6-bit positive or negative signed relocation displacement, and the 
parameter's termination character specifies the function that i3 to be 
performed. A carriage return or a period termination character tells 
MUDBUG to load the values from the object tape into memory, and a comma, 
space, tab, or asterisk termination character tells MUDBUG to compare the 
object tape to memory. 


The object tape that is loaded or compared- to memory is offset from 
its normal memory locations by a displacement that is equal to the START 
parameter. For example, if START =. -$1000, an object module with an. origin 
.of- $4000 would be loaded.;:into (or” compared to) memory starting-at location: 
$’3Q00^ 7 Slniilarly, lf a user specifies START' = ■*■$2000, - an object module 
with an origin of $5000 would be loaded into — Cor_- com par ed_:-toJ--— memory-- 
starting at location $7000.- For normal lab w ork^-I moatTruaera empl o y—the "H*, 
command- with START- = 0 to load oh compare programs- with/ ho displacement. 
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but nonzero displacement values are frequently necessary when MUDBUG is 
used in special applications such as M6800- based PROM programmers. 

When MUDBUG performs a compare function, the MUDBUG Load/Compare 
routine prints three hex values for each object-tape word that fails to 
match the corresponding word in memory. The three values that are printed 
are as follows: 

Memory Address Memory Value Tape Value 

When MUDBUG performs a load function, the loader generates a compare 
printout as above for any word that can' t be loaded, so attempts to load 
into ROM or nonexistent memory are flagged for the user. 

If an invalid object tape is input to the loader or if a bad read 
occurs or if a checksum error is detected, the Load/Compare routine aborts 
execution with a backslash and a bell. 


"M" Command; 3 Parameters; Memory Dump. 

The "M w command requires three parameters known as . START, MSTOP, and 
SCREEN. If MSTOP >= START and MSTOP is not typed with a leading plus sign, 
the "M" command nominally dumps locations START through MSTOP in both 
hexadecimal and ASCII format to the user' 3 terminal. If MSTOP < START on 
the other hand, (or if MSTOP is typed with a leading plus 3ign), the "M" 
command uses MSTOP as a count and nominally dumps MSTOP locations beginning 
with location START. The third parameter for the "M B command, which i3 
known as the SCREEN parameter, specifies the maximum number of lines that 
MUDBUG will dump before pausing. The SCREEN parameter allows the user to 
control the dump interactively, so the user can prevent information from 
scrolling off the top of a CRT screen too quickly. 

MUDBUG prints the memory dump with 16 values per Un a, and the dump is 
formatted for ease of readability. Each line of the dump begins with the 
hexadecimal memory address of the first value on the line. Then the line 
contains 16 hexadecimal values corresponding to the values of the 16 memory 
locations that are being dumped. At the end of each line MUDBUG prints 16 
ASCII characters corresponding to the ASCII character codes (if any) that 
reside in the 16 memory locations that are being dumped. If a location 
doesn't contain a printable ASCII character, MUDBUG prints an underscore 
for that location. 

The memory dump actually 3tart3 with the location whose address is 
FLOOR [START/ 1 63*16, so the hexadecimal memory address of the first word of 
the dump always ends with zero. The default value for START is the current 
'' Value of: the MUDBUG: START- parameter. ~ w 


The "M w command uses its own private MSTOP parameter "instead of us i n gs' 
MUDBUG* s global STOP parameter, ' .and ..the MSTOP parameter - tells:* MUDBUG- where-— 
to stop dumping. If. MSTOP >= START, and the MSTOP parameter is not typed 
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with a leading plU3 sign, the memory dump ends with the location whose 
address is FL00H(ST0P/16]*16 + 15. Notice that the memory dump always 
starts with the line that contains location START, and the memory dump ends 
with the line that contains location MSTOP. 

If MSTOP < START, MUDBUG conveniently interprets the MSTOP value as a 
count of the number of locations to dump. For example, if START = $2000 
and MSTOP = $100, MUDBUG 'dumps $100 locations starting at location $2000. 
Since MUDBUG always prints values for 16 memory locations on each, line of 
the dump, MIDBUG sometimes dumps a few more locations than the act ual 
number that were specified by the MSTOP parameter. For example, if 
START = $2005 and MSTOP = $3, MUDBUG act ual ly dumps locations $2000 through 
$200F. 


If the user types a plus sign as a leading sign character with the 
MSTOP parameter, MUDBUG interprets the MSTOP value as a count of the number 
of locations to dump even if MSTOP >= START. This feature allows a user to 
use the count option even when the starting address for the memory dump is 
a small number. For example, a user could type "M 10, +20" to dump $20 
locations beginning at location $0010. 

The MSTOP parameter doesn't have a default value. If the user omits 
the MSTOP parameter, MUDBUG potentially dumps forever and never stops the 
dump at any particular address. Instead, MUDBUG stops the dump only when 
the user interactively chooses to stop it. The user can interactively tell. 
MUDBUG to stop the dump by typing a termination character during the pause 
at the end of a screen. This feature is extremely convenient because it 
allows the user to dump interactively and to terminate the dump only when 
desired. 

The SCREEN parameter tells MUDBUG how many lines it should dump to the 
terminal before pausing to let the user control the dump interactively. The 
default value for the SCREEN parameter is $10 s 16, so MUDBUG normally 
dumps 16 lines containing $100 locations per screen. MUDBUG accepts SCREEN 
parameters In the range from $00 through $FF (255), and MUDBUG interprets 
any value larger than $FF by taking its value modulo 256. Notice that the 
SCREEN parameter, like all MUDBUG parameters, is typed as a hexadec ima l 
number, not as a decimal number. 

Zero is a special value for the SCREEN parameter, and it means that 
MUDBUG should never pause. Zero is therefore equivalent to an infinite 
value for the SCREEN parameter, and a zero SCREEN parameter is useful for a 
person who is using a hardcopy terminal. Notice that a user can put MUDBUG 
into an infinite dump by specifying zero for a SCREEN parameter and also 
omitting the MSTOP parameter. This somewhat dubious feature allows a user 
to make MUDBUG run continuously over a weekend to verify that a particular 
microcomputer can run that long without- any glitches. 

When MUDBUG "reaches the end of" a screen of the memory dump^the: system - 
pauses with the cursor at the beginning of the nextr line^orr— the te rmi na l- . - 
MUDBUG waits at- this., point- (forever- if necessary ^ustelL^the^userr types - . -an- , 
input character to tell. MUDBUG. what to do next,, so: the user -can control.. the 
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dump interactively. The choices are similar to the choices that a user Has 
with the memory-change command. 

If the user types a carriage return (<CH>), MUDBUG displays the next 
screen of data. The <CH> therefore allows a user to scroll through memory 
until all relevant values have been displayed. MUDBUG considers memory to 
be. circular,, so location $0000 logically follows location $FFFF in memory. 

If the user types a comma, MUDBUG re-displays the current screen of 
data. A comma therefore allows a user to re-examine a particular area of 
memory as often as desired. A user might want to use commas to keep 
examining some locations that correspond to the registers of an input 
device that is receiving inputs from an external source. 

If the user types an asterisk, a blank space, or a tab, MIDBUG 
displays the previous screen of data. The previous screen of data is the 
screen of data that corresponds to the memory locations that immediately 
precede the locations of the current screen in memory. The asterisk, 
blank, and tab allow a user to scroll back through memory until all 
relevant values have been displayed. A user can use a <CR> after one 
screen and an asterisk after the next screen to bounce back ami forth 
between two screens of data. 

If the user types a period, a solidus, or any cither character that 
hasn't been mentioned above, MIDBUG terminates the dump and returns control 
to the top of MUDBUG to wait for the next command. 

The interactive dumping feature is much like the memory-change 
command, and it is extremely convenient to use. For example, a user can 
interactively dump memory starting at location $2000 by simply typing 
"M 2000<CH> B to tell MUDBUG to start the dump in the interactive mode. On 
the other hand, a user who wants to dump $80 locations beginning at 
location $2000 can perform the dump non- interactively by typing either 
"M 2000, 207F<CH>" or «*M 2000, 80<CB>" to tell MUDBUG to dump the desired 
area of memory. 


"N" Command; 1 Parameter; N-Step Command. 

The "N" command, which requires one parameter, is useful for debugging 
an otherwise intractable section of a program. The ,r S n command is known as 
the U-step command, and it tells MUDBUG to execute the next N instructions 
of the user's program where the value of N is defined by the "N" command's 
parameter. For example, a user could type Tt 5" to tell MUDBUG to execute 
the next five instructions of his or her program. MIDBUG provides a 
register dump after executing the next If instructions of the user* 3 
program, and, then control goes back to the top of MODBUG to wa it fo r 
another MUDBUG command from the user. - - ---- — 

Suppose that a user types 5 T as suggested above to execute the next 
five ins tructions of his or her pr ogram. Suppose further that tha user 
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then wants to execute five more instructions- In this case,, the user could 
simply type "N<CR>* because MIDBOG remembers that, the previously— specified, 
parameter value was five. The default value for- the *N* c ommand * a 
parameter is always taken from the previously-defined STABT parameter. 

The N-step command tells MUIBOG to execute the next S ins truc tions of 
the user' s program, and the next instruction: to be executed in a program is _ 
always indicated by the PR; An N-step command therefore causes MUDBUG to 
execute the next N instructions starting at the location that is indicated 
by the pseudo PR. Clearly, the pseudo PR must point to the desired program 
segment before the N-step command can be used. Therefore, the N-step 
command should normally be used after the user has executed part of a 
program and has trapped control at seme point of interest in the program. 
Control can be trapped at some desired point in the user* s program by 
including a software-interrupt instruction (SHI) at that point or by using 
MJDBOG r s "T* command. There are other ways to trap control at same 
specified point, but MUDBUG *s "T* command, which is explained elsewhere in 
thi3 chapter, provides the most convenient method. 

A user can also use the "PR" command, which is explained elsewhere in 
this chapter, to set the pseudo PR to a desired location before using the 
"S" command. However, this approach is error prone because it- allows the 
user to start somewhere in the middle of a program without executing the 
first part of the program. The first part of the program may be necessary 
to set up the conditions that allow the next part of the program to execute 
properly. 

Most users employ the T N rr command as follows. First they use the "T 1 * 
command to trap control at the beginning of a suspected problem area, and 
then they use the T N n command to execute a few instructions at a time in 
the problem area to examine the problem in detail. 

The user should always remember that the. TT N IT command* s parameter, like 
all of MUDBUG'3 parameters, is interpreted as a hexadecimal number. Typing 
"N 10," therefore, tells MIDBUG to execute the next $10 (i.e., 16) 
instructions of the 1 " user's program. For purposes of debugging, most users 
tend to execute only two to six instructions with each use of the "N" 
command, and there is no difference between hex and decimal numbers in this 
range of values. 

Although most people use the "N" command with small parameter values, 
the "N" command accepts any 1 6-bit unsigned number for its parameter. A 
parameter value of zero is interpreted to mean 65,536, so a user can 
execute a maximum of 65,536 instructions with a single use of the "N" 
command. 

Some users employ the "N" cnmntanri with large parameter values to 
determine- how-, many .instructions are -"executed, in ... a;' - ; particular- programmers 
subroutine. In this application" the "N w command is useful, as ah aidrfor 
making timing measurements, (in terms of"~ ther— number-- of— instructions - 
executed). ' ; -r---— ~ r 


T 


21 

Using tiie "N" command puts MUEBUG into step node* When MTDBUG is in 
step mode, the system changes its prompt from the normal ">" to a *?* to 
let the user know that MUEBUG is in step mode. Step mode i3 Just like 
normal mode with one important exception. When MUEBUG is in step mode, the 
user Mn simply type a carriage return as a MUDBOG command to tell MUEBUG 
to execute the next instruction of the user's program. Thus a user can 
conveniently step through- a program one instruction at a time by simply 
typing a carriage return at each step. In this case MUEBOG provides a 
register dump after each instruction is executed. 

When MUEBOG is not in step mode, a carriage return alone i3 treated as 
a do-nothing command. A user can therefore type a carriage return as a 
MUEBOG command in normal mode to advance the cursor to a new line. 

MUEBOG automati cal ly returns from step mode to normal mode whenever 
the user types any non-debugging command (except a comment command) or when 
the user types an invalid command. The debugging commands are the "N" 
command r the "0* command, the *T W command, and the "V* command. In other 
words, any command that tells MUEBUG to execute a portion (but not all) of 
the user’s program is a. debugging command.. De bugging commands normally put 
MUEBUG into step mode, and other commands (except the comment command) take 
MUEBUG out of step mode. Step mode is designed to provide a convenient 
single-step mechanism for the user who is debugging a program. 

MUEBUG temporarily treats the "N" command as an illegal command when 
the pseudo stack pointer has been set to address ROM. or nonexistent memory'. 
This feature protects the user from Inadvertently transferring control to 
his or her program with an invalid value in the stack pointer. Please 
refer to the discussion of the "S* command for details. 

The "W" command is available only on systems that have the necessary 
hardware to support step-mode operations. If the system, on which MUEBUG is 
running doesn* t have the necessary hardware to support step-mode 
operations, MUEBUG treats the "N ,T command as an invalid command. 


"0" Command; 1 Parameter; One-Step Command. 

The "0" command, which requires one parameter, tells MUDBUG to execute 
one Instruction in the user's program. The "0" command's parameter tells 
MUEBUG the address of the instruction that is to be executed. MUEBUG 
executes the specified instruction and provides a register dump after the 
Instruction has been executed.. Then MUEBUG automatically goes into step 
mode, anrj control returns, to the top of MUEBUG to wait for the user' s next 
command. 

default _ . value for the 0ne—3tep command' s parameter Is_m^ taken 
f r om the previously- 3 pacified. START parameter. Instead^ the- default^ valued ~ 
for the One-step command's parameter in taken front— the pseudo, ra r and-_the 
START, parameter is neither used nor affected — bvr-.~aii^?QE:: comma nd- • • B y -using- — 
the. pseudo PR as a default value- for the "0* command's parameter^. MUDBUG 
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conveniently allows the user to execute the next instruction of his or- her 
program by simply typing "0<CB>“ with no parameter value* 

The One-step command is a powerful debugging aid. If all else fails, 
a desperate programmer can always use the "0" command to single step 
through a small program, segment that is causing problems that temporarily 
seem to be insoluble. 

Most users employ the "0" command as follows. First they use the B T B 
command to trap control at the beginning of an intractable problem area, 
and then they use the *0" command with its default parameter value to 
execute one instruction ah a time in the problem area until they've 
discovered the exact cause of the problem. 

A successful use of the "0" command always puts MUDBUG into step mode. 
MUDBUG changes it3 prompt from the normal ■>" to a B ? B to let the user know 
that the system is in step mode, and a carriage return as a response to a 
B ? B prompt tells MUDBUG to execute the next instruction in the user's 
program. Thus a user doesn' t even need to type an B 0 B to request another 
"0" command ; a carriage return alone is sufficient when the system is in 
step mode- MUDBUG provides a register dump after executing an. instruction 
in step mode, and the user can conveniently step through a program one 
instruction at a time by simply typing a carriage return at each 3tep. 

When MUDBUG Is not in 3tep mode, a carriage return alone is treated as 
a do-nothing command. A user can. therefore type a. carriage return as a 
MUDBUG command In normal mode to advance* the cursor to a new line. 


MUDBUG automatically returns from 3tep mode to normal mode whenever 
the user types any non-debugging command (except a comment command) or when 
the user types an Invalid command. The debugging commands are the "N" 
command, the "0" command, the "T B command, and the T" command, so any 
command that tells MUDBUG. to execute a portion (but not all) of the user's 
program is a debugging command. Any debugging command that is executed 
successfully put3 MUDBUG Into step mode, and other commands (except the 
comment command) take MUDBUG out of step mode. Step mode i3 designed to 
provide a convenient single-step mechanism for the user who is debugging a 
program. 

MUDBUG temporarily treats the "0" command as an illegal command when 
the pseudo 3tack pointer has been set to. address HGM or nonexistent memory. 
Thi 3 feature protects the user from inadvertently transferring control to 
his or her program with an invalid value in the stack pointer. Please 
refer to the discussion of the B S B command for details. 


The "0" command is available only on systens that have the necessary 
hardware to support step-mode operations. If the system on which MIDBUG is 
runni ngrrdo es n it have- the necessary" hardware - t cr v : sup port : ::: 3 tep- mode 
"operations, - MUDBUG treats the "0* command as- an lnvaild:~conunand.~ r 
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"PE" Command; 1 Parameter; Peek at Memory. 

The "PE" command allows a user to peek at a memory location with the 
assurance that MIJDBOG will not write anything to the memory location. The 
"PE" command, which has one parameter, displays the address and the 
contents of memory location START, and then it waits for the user to type a 
termination character- Actually, the "PE" command, waits after displaying 
the address and value of' location START for the user to type a hex input 
number, but the command ignores the value of the input cumber and uses only 
the number's ter mina tion character. 

The termination character allows a user to continue the "PE" command 
the same way a user can continue the "C" command, and the termination 
characters that are used with the "PE” command have the same meanings that 
they have with the "C" command. The "PE" command is therefore exactly like 
the "C" command except that MUDBOG never writes anything to the specified 
memory location when the user uses the "PE" command. 

The "PE" command is extremely useful when a user wants to examine a 
read-only register such as the status register of an ACIA. If a user tried 
to use the "C" command to examine the status register of an ACIA, MJDBOG 
might try to write a new value back into the location of the status 
register, but the write operation would fail because the status register of 
an ACIA is a read-only register. Furthermore, the write operation in this 
case would have bad side effects because the read-only status register of 
an ACIA 3hares its memory address with the ACIA* 3 write-only control 
register, and the status register's value would actually be written into 
the ACIA ' 3 write-only control register. 

The "PE" command is generally intended for users who are dealing with 
special hardware devices that have read-only registers, but other users can 
also use the "PE" command to examine ordinary memory locations. 


"PO" Command; 1 Parameter; Poke a Value into Memory. 

The "PO" command allows a user to poke a value into a memory location 
with the assurance that MDDBOG will not try to read from the specified 
location. The "PO" command, which has one parameter, displays the address 
(but not the contents) of memory location START, and then it waits for the 
user to type a value that is to be put into location START. 

The termination character of the new value allows a user to continue 
the "PO" command the sam e way a user ran continue the "C" command, and the 
termination characters that are used with the "PO" command have the same 
meanings that they have with the "C" command. The "PO" c ommand Is 
therefore exactly:; like the "C"-command except that MGDBQg .never: . reads fro m- 
the - specified memory" location wfaen the user uses the J'PO " command- " - 

If a user types a hard termination character- (-/ . or^ <CR>) alone 
without a number- for an input value, MUDBOG doesn't poke^ anything into- the 
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specified location. The function of the termination character regarding 
the continuation or termination of the »P0" command is still effective, 
though, so a user can conveniently skip over a location with the "PO" 
command. • 

The "PO" command is extremely useful, when a user want3 to put a value 
into a write-only register such as the output data register of an A cra T Tr 
a user tried to use the *C* command to put a value into the output data 
register of an ACIA, MUTBUG would try to read back the value to verify that 
it was stored correctly. The verification would fail, though, because the 
output data register of an ACIA is a write-only register. Furthermore, the 
attempted verification would have bad side effects in th±3 case because the 
write-only output data register of an ACIA shares its memory address with 
the ACIA* s read-only input data register. The attempted verification would 
cause MQDBOG to read from the ACIA's read-only input data register, and a 
read operation that accesses an ACIA' s input data register causes the ACIA 
to change 3ome of its internal, status flags. 

The "PO" command is generally intended for users who are dealing with 
special hardware devices that have write-only registers or registers that 
are sensitive to read accesses, but other users can also use the "PO" 
command to poke values into ordinary memory locations. 


"PH" Command; Ho Parameters ; Change PR. 

The "PR" command, which doesn* t require any parameters, displays the 
current hexadecimal value of the pseudo PR, and then it accepts a new hex 
value for the PR. If a user types a hard termination character (/ * , .or 
<CR>) alone without a number for a new PR value, the pseudo PR retai ns its 
present value. The "PR" command really isn't necessary for ordinary 
operations^ but some users like to use it to control the value of the PR. 


"Q" Command; Ho Parameters; Query Registers. 

The "Q" command doesn't require any parameters, and it prints the 
values of the pseudo registers just, as the execution of a software— 
interrupt instruction (SWI) normally does in the following format: 

AH BR XR PR SP HINZVC 
aa bb xxxx pppp 3sss cccccc 

All values are printed in hexadecimal with the exception of the condition- 
code values, which are printed in binary for ease of interpretation. Since 
there are only six actual bits in the. condition-code register, only six 
--bits- are printed. ' The-condition^code bits are interpreted; an?foEllowsrr^-:T^=r 

I = interrupt maair — — S' = negative - - 

T - overflow* -=--iG.=- carry/borrow 


H - half carry 
Z. = zero 
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The "Q" command provides a disctinctive output, so the "Q" command is 
a good command to use if the user wants to see If control is actually in 
MUDBDG. The "Q n command is also a good command to use if the user wants to 
change MUDBDG from step mode to normal mode with no side effects. 


"I" Command; 1 Parameter? Relative Addressi n g. 

The "R" command, which requires one parameter, is used to determine 
and/or to set the destination address of a branch-class instruction. The 
second word of a branch-class instruction in the M6800 always contains a 
signed, 3elf-relative displacement value, so the destination address of a 
branch-class instruction isn't immediately obvious to most people by 
inspection. The "R" command, however, allows the user to determine and/or 
to 3e t the destination address of a branch-class instruction rather easily. 

The START parameter is assumed to be the memory address of. the second 
word of a branch-class instruction, and the n R" command computes and prints 
the instruction' s destination address based on that assumption. 


Then the "R" command waits for the user to type a new value for the 
destination address. If the new destination address that is typed is out 
of range for the branch-class instruction that is being processed, MUDBDG 
outputs a backslash and a bell and aborts the B R B command. Otherwise, the 
"R" command computes and prints the new self-relative displacement value 
that will give the branch-class instruction the desired new destination 
address. Additionally, the "H" command puts the new self-relative 
displacement value into the second word of the branch-class instruction in 
memory, so the instruction is automatically changed in memory to address 
the desired new destination. If the second word of the bra nch- class 
instruction happens to be in ROM or nonexistent memory, of course, the "R” 
command aborts with a backslash and a bell instead of changing the self- 
relative displacement value in memory. 


The termination character (blank tab / * , .or <CR>) that is used to 
terminate the new destination address is interpreted jU3t as the 

termination character is interpreted by MUDBDG * s "C 1 * command: A carriage- 

return terminator causes MUDBDG to proceed automatically into the B C B 
command after first setting START < — START -t- 1 , so the location 

Immediately following the branch-class instruction in memory is opened for 
changing via the "C B command. An asterisk, blank, or tab termination 
character causes MUDBDG to proceed into the B C B command after first, setting 
START < — START - 1 , so the first word of the two-word branch-class 
instruction is opened for changing via the B C B command. A comma te rmina tor 
causes MUDBDG to proceed into the "C* command with no change to the START 
parameter, 30 the second word of the two-word branch-class instruction is 
opened for* changing.., via the "C ,r command—. A period. .terminator returns 
control to the top of MUDBUG~af ter the "R"" command has put the new self— r 

relative displacement- value into memory, and a solidus te rmina tor aborts 

the "R* command at once before it can change anything inmemory - 
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If a user types a hard termination character (/ • , .or <CR>) alone 
without a number for a new destination address, HJDBUG retains the existing 
destination address and treats it as the desired destination address. The 
function of the termination character regarding the continuation or 
termination of processing as discussed above is 3tlll effective, so the "H* 
command is conveniently useful for checking destination addresses without 
necessarily changing them. 

The "R" command alleviates 3ome of the headaches of self-relative 
addressing by allowing a user to follow the logical flow of his or her 
Program conveniently and easily. In fact, if the second word of a branch- 
class instruction has Just been examined via the "C" command, the user 
needs only to type "R. B or B R<CR>" to invoke the B R" command 3ince the 
START parameter is already set properly from the previous B C" command. 

The "R" command is also extremely convenient for users who write smal 1 
programs in machine language, and it is equally useful for making machine- 
language patches to larger programs during debugging. When the user 
an ploy s the "R" command, MOIBOG takes care of all of the annoying details 
of self-relative addressing, so the user can conveniently think, in terms of 
direct memory addresses. 


"S" Command; No Parameters; Change SP, the Stack Pointer. 

The B S B command, which has no parameters, displays the current hex 
value of the pseudo stack pointer (SP), and then it accepts a new hex value 
for the pseudo 3tack pointer. If a. user types a hard termination character 
(/ * , . or- <CR>) alone without a new stack-pointer value, the pseudo stack 
pointer retains its present value. 

The user should exercise a certain amount of caution and good judge- 
ment when changing the pseudo stack pointer because the stack pointer must 
always point into a RAM area of memory with at least 7 locations of RAM at 
and below the stack pointer. In other words, if SP represents the value of 
the stack pointer, locations SP, SP-1 , SP-2, ..., and SP-6 must all be 
locations in a RAM (read/write) area of memory. At least 7 locations of 
RAM must be available for the user' s stack at all times because 7 locations 
are required for saving the M6800 registers in the event of an interrupt. 

Most users would be wise to provide quite a few more than 7 locations for 
the stack because multiple interrupts can always occur. In fact, users 
should even be cautious about changing the stack pointer via instructions 
in their programs because all M68Q0 programs should (indeed must) be ready 
to accommodate an interrupt at any time. 

If the 3tack pointer is ever set in such a way that fewer t h a n 7 
tn rat-.j on*? HAM ' ai-ft- av a-M ahi a. fnr»- the stack, MDDBUCJ ..temporarily makes--- the — - 

"(j r B "H," "N,“ "0 ," and- - "tv- commands illegal, sa the errant- user is -- — - — 

protected from being able to transfer control, into- his-or her -cwn- program- 

with- the stack pointer initially pointing into R0t or nonexistent- memory. — .1 ' 
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Moat beginning users will never need the "S" command, but the command 
is made available as a convenience for the relatively sophisticated users 
who will want and need it. The ”S* command can be used to reset the pseudo 
3tack pointer following a program error or a partial execution of a 
program, so the user can always keep the pseudo stack pointer pointing into 
a desired HIM. area. 


"T" Command; 4 Parameters; Trap. 

The "T* command, which is used to trap control at any desired point in 
the user's program, can accept as many as four parameters. Before we 
consider the case of a four-parameter "T* command, though, let us first 
discuss a two-parameter "T" command. If the user types a carriage return 
to terminate the "T" command's second parameter, MJDBUG automatically 
provides innocuous default values to make the remaining two parameters 
transparent to the user. 

The first two parameters for the "T n command are known as TSTART and 
STOP. The "T" command starts execution of the user's program at location 
TSTAHT, and then it uses a software interrupt to trap control when or if 
control reaches location STOP. When (i.e., if) control reaches location 
STOP, the trap interrupt returns control to the top of MJDBUG after first 
invoking a routine that prints the values of the registers just an if a "Q" 
command had been input. The user's instruction at location STOP is not 
executed, so following a successful trap operation the pseudo PR points to 
location STOP, which contains the first word of the next sequential 
instruction to be executed in the user's program. This particular value of 
the pseudo PR conveniently allows the user to continue the execution of his 
or her program if desired. For example, the user might employ an "H™ 
command, an "N" command, an "0" command, or another "T n command to continue 
execution of his or her program. 

Notice that the first parameter for the "T" command is called TSTAHT. 
The "T" command uses it3 own private TSTART parameter instead of using the 
3y3tem-defined START parameter that is used by most other MIDBUG commands. 
Therefore, the T" command can have a unique default value for it3 TSTART 
parameter instead of using the standard default value of the general- 
purpose START parameter. The "T" command uses the value of the pseudo PR 
as the default value for the TSTAHT parameter, so the user can conveniently 
continue trapping through his or her program from one segment to the next 
without typing a new TSTART parameter at each step. For example, typing 
"T , 2100" continues execution from the present point in the program and 
traps control at location $2100. Using the pseudo PR as the default value 
for the TSTAHT parameter is particularly convenient because the pseudo PH 
retains its useful significance even if several operations (e.g. , memory 
dumps ^ "C^ commands,,; etc. ) are- performed between, successive *17 command s. - 

MJDBUG ’3 "T* - command is probably the single _ most powerful debugging. - 

tool that is available to the system's use rs By_u sing _the "T" 1 command,, a. - . 

user can execute any selected portion of a program, so a, programmer can 
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interactively trace the flow of a program, at execution time and e asil y 
isolate an error to a small routine or even to a single instruction. Users 
who quickly' master the efficient use of the *T* command inevitably find 
that debugging their programs becomes an almost trivial task. 

As with other commands that request execution of the user's program, 

MUDBUG temporarily treats the "T" command as an illegal command when the 
pseudo stack pointer has' been set to address ROM or nonexistent memory. 

This feature protects the user from inadvertently transferring control to 
his or her program with an invalid value in the stack pointer. Please 
refer to the discussion of the B S B command for details. 

The "T" command is also illegal if location STOP happens to be in ROM 
or nonexistent memory. This restriction is necessary because the routine 
that implements the "T B command's function must temporarily store a 
3oftware-interrupt instruction (SWI) into location STOP. If the user tries 
to specify a STOP address in ROM or nonexistent memory, MUDBUG aborts the 
"T B command with a backslash and a bell. 

The n T n command traps control at location STOP via a software 
interrupt, so users who employ the "T B command should carefully insure that 
their programs always keep the stack pointer pointing into enough RAM to 
support an interrupt. If the user's program fails to maintain the stack 
pointer in such a way that the 3tack can support as interrupt properly at 
the trap point (i.e. , when control reaches location STOP), the "T B command 
still traps control successfully at location STOP, but the invalid stack- 
pointer value generally causes seme or all of the software-defined pseudo 
registers (other than the pseudo stack pointer) to be 3et erroneously 
following the trap at location STOP. 

Notice carefully that the trap point (I.e., STOP) must be the first 
word of an instruction. Control cannot be trapped in the middle of an 
instruction, and any users who try to trap control in the middle of an 
instruction will experience erroneous results. 

A successful use of the "T* command automatically puts MUDBUG into 
step mode if the hardware of the system supports step-mode operations. The 

"T B command is considered to be successful if control is successfully 
trapped at the specified STOP location. If control stops somewhere else, 
of course, the "T n command is not considered to be successful. 

When MUDBUG is in step mode, the MUDBUG prompt is changed from the 
normal ">" to a B ? B to let the user know that the system is in step mode. 

The user can simply type a carriage return as a response to a B ? B prompt to 
tell MUDBUG to execute the next instruction of the user's program. Thus a 
user who has jU3t trapped control with the "T B command can conveniently 
step through the next section of hia or - her program one instruction at a 

hy pim p ly typ ing a carriage return _at each, step-^ MUDBBG.._provides a 

' register dump af ter each 3tep when instructions are~executed„oneatra - ’time^^— T t- 
in step. mode. - 
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When MUDBUG is not in step mode, a carriage return alone is treated as 
a do-nothing command. A user can therefore type a carriage return as a 
MUDBUG command in normal mode to advance the cursor to a new line. 

MUDBUG automatically returns from 3tep mode to normal mode whenever 
the user types any non-debugging command (except a comment command) or when 
the user types an invalid command. The debugging commands are the "N n 
command, the "0" command* the "T*' command, and the ”7” command. In other 
words , any command that tells MUDBUG to execute a portion (but not all) of 
the user’s program is a debugging command. Debugging commands that are 
executed successfully put MUDBUG into step mode, and other commands (except 
the comment command) take MUDBOG out of step mode. Step mode is designed 
to provide a convenient slngle-3tep mechanism for the user who is debugging 
a program. 

Now let us consider the ’’T" command’s third and fourth parameters. 
The "T" command '3 third and fourth parameters are available only if the 
system on which MUDBOG is running has the necessary hardware to support 
step-mode operations. If the system' s hardware doesn't support step-mode 
operations, MUDBUG allows only the first two parameters for the "T" 
command. 


The "T” command’s third parameter is generally known as the stop-count 
parameter. The stop-count parameter, which is useful for debugging loops, 
can be used when the user wants control to go through a loop sane specified 
number of times before- control i3 trapped at a specified instruction, in the 
loop. If the value of the stop-count, parameter i3 nine,, for example, 
MUDBUG traps control the ninth time that control reaches location STOP (if, 
in fact, control reaches location STOP nine times). The instruction at 
location STOP is executed normally the first eight times, it is encountered, 
but control is trapped and the instruction is. not executed, the ninth time. 

Following a successful trap operation the pseudo PR points to location 
STOP, which contains the first word of the next sequential instruction to 
be executed in the user* s program. The PR is therefore set properly to 
allow the user to continue the execution of his or her - program via any of 
several MUDBUG commands. For example, the user might want to use MUDBUG’ s 
step-mode feature to execute the next few instructions one step at a time. 

The user should always remember that the stop-count parameter, like 
all of MUDBUG’ s parameters, is interpreted as a hexadecimal number. Typing 
"lOO” for the stop-count parameter therefore tells MUDBUG to trap control 
the $100th (i.e. , 256th) time that control reaches location STOP. MUDBUG 
treats the 3top-counh parameter as a 16-bit unsigned value, and MUDBUG 
interprets the value zero to mean 65,536- 


The default value 
user who wants to trap 
can simply omit the. 
therefore conveniently 


for the stop-count parameter is always one, so a 
control the first- time, control-reaches lo cation STOP 
st o p— co unt ~ parameter. The stoj>-count feature- la-, 

transparent when it is .not bein g u sed. 


30 


Notice that the stop-count parameter is a private parameter that i 3 
used only by the "T" command. The stop-count parameter is not related to 
the system-defined KEY parameter that appears as the third parameter of 
some other MUDBUG commands. 

The "T" command* 3 fourth parameter, which is useful only if the stop- 
count parameter has been, specified, is known as the print-count parameter. 
The print-count parameter tells MtJDBOG how frequently the system should 
generate a register dump. For example, if the value of the print-count 
parameter is three, MODBUG generates a register dump every third time that 
control reaches location STOP. MtJDBOG generates the register dump 
immediately before the instruction at location STOP is executed. 

The print-count parameter provides a method for obtaining dynamic 
register dumps as the user's program is executing. MJDBUG always generates 
a register dump when control is actually trapped at location STOP, and the 
print-count parameter can be used when the user wants to see some register 
dumps at some intermediate steps as well. 

The user can specify any desired value for the print-count parameter 
if intermediate register dumps are desired. For example, if a user 
specifies the value one for the print-count parameter, MUDBOG prints a 
register dump every time control reaches location STOP. Similarly, if a 
user specifies the value five for the print-count parameter, MUDBOG prints 
a register dump every fifth time control reaches location STOP. 

The default value for the print-count parameter is always taken from 
the value (if any) that was specified for the stop-count parameter. By 
default, therefore, MOD BOG generates a register dump only when control is. 
actually trapped. The default value for the print-count parameter 
conveniently makes the print-count feature transparent when it is not being 
used. 


Like all other MODBUG parameters, the print-count parameter is always 
interpreted as a hexadecimal number. MUDBOG treats the print— count 
parameter as a 1 6-bit unsigned number, and the value zero is interpreted to 
mean 65,536. The print-count parameter is a private parameter that is used 
only by the n T" command, and the print-count is not related to the system- 
defined MASK parameter. ’ 


"V" Command; 4 Parameters; Verify ROM Program. 


The "V" command is functionally identical to the "T B command, but the 
"V n command can be used with a program that resides in ROM whereas the "T” 
co mman d cannot be used with a program that resides in ROM. The "V n c omm a n d 
is available only if. the system on. which MUDBOG is runni n g has the hardware 
that " is- ^necessary?— to - support -step-^mode operations^ _ If . the-^systesK^nanit 
support step-mode operations, MODBUG treats the "V" command as an invalid 
command. 
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Although the Ir 7" command can be used with programs that reside in RAM 
or pseudo ROM, the "T" command is better for those programs. The "V" 
command executes a program much more 3lcwly than the "T* command does, so 
the "V" command is clearly unsuitable for any programs that contain any 
real-time segments. 

The "Y" command is provided as a special command that is occasionally 
useful in a ROM environment, but most users seldom have any real need to 
use the "V" command. 


Command; 2 Parameters; Write Object Tape. 

The "W" command, which requires two parameters, writes the values of 
memory locations START through STOP to the terminal in M68Q0 object format. 
If a tape-producing device is attached to the terminal, the "W n command 
produces an object tape that is compatible with any standard M6800 loader. 

If the STOP parameter i3 terminated by a comma, a blank space, a tab, 
or an asterisk, the "S9" record and the trailer (i-e. , nulls) that normally 
mark the end of an M6800 object tape are not written, so users can 
conveniently write several disjoint areas of memory onto a single object 
tape by simply invoking the "W ff command several different times with comma 
terminators. 

A carriage-return or period terminator for the STOP parameter, of 
course, causes the "S9" end-of-tape record and six inches of trailer to be 
written normally, and the carriage-return terminator is therefore the 
terminator that most users type for ordinary lab work. 

The "W" command is useful for obtaining a reloadable object tape of a 
program, that has been modified in memory during debugging. This object, 
tape can then be reloaded later (via the "L" command) if the user's program 
i3 ever accidentally destroyed in memory, so the user doesn' t need to waste 
any time recreating patches and modifications that have already been made 
once. Since a power interruption or a minor programming error can. eas il y 
destroy a program that resides in HAM, users can potentially save a great 
deal of time and effort by using the "W" command before their programs are 
destroyed. 


"X w Command; No Parameters; Change ZR. 

The "X" command, which doesn' t require any parameters, displays the 
current hexadecimal value of the pseudo XR, and then, it accepts a new hex 
value for the XR. If a user types a hard termination character^/ * , . or 
<CB>) alone- without, a. number- for- a new XR value, the pseudo XR ret ain s its. 
present value. 
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"Z" Command; No Parameters; Zero Registers. 

The "Z" command, which doesn't require ary parameters, initializes the 
registers as follows: It clears the pseudo AR, BR, XR, PR, and CC 
register, and it reinitializes the pseudo stack pointer to point to the 
user' s default stack area in the MUDBUG RAM. 

The "Z w command provides a quick way of reinitializing all of the 
pseudo registers with a single command, so the user doesn't need to type 
individual co mman ds to initialize each register individually. 

Users should carefully note the fact that a restart interrupt (RSI) 
performs the function of a "Z" command besides restarting MDTDBOG as if a 
power-up condition had occurred. 


Chapter 4 


Internal Routines and Subroutines 


MDDBDG quite naturally includes several internal subroutines, and many 
of these internal subroutines are potentially useful for general-purpose 
applications. Some of MDDBDG’ s internal subroutines have therefore been 
made available to the systan's users, and programmers who wish to invoke 
any of MDDBDG’ s internal subroutines can simply call the desired routine(s) 
from their own programs. MDDBDG users can thu3 avoid the unnecessary 
effort of re-inventing and re-coding any routines that have already been 
implemented in MDDBDG. 

There is one caution that users must observe before writing any 
programs that call any of MDDBDG’ s internal routines: Future releases of 
MDDBDG will not necessarily be completely compatible with the current 
version of MDDBDG with regard to internal subroutines. MDDBDG’ s internal 
subroutines are offered to the system’s users only as a convenience factor, 
not as a fully-supported feature, and any users who lock themselves 
inflexibly into MDDBDG ’3 current set of internal routines may have some 
difficulty upgrading to subsequent new releases of the MDDBDG system. 

The alphabetized list of routines on the next page summarizes the 
internal MDDBDG routines that are available to the system ' 3 users,, and 
interface characteristics such as cal ling-sequence requirements and return 
conditions are given for each subroutine in the pages that follow. Notice 
that the entry points for the available internal routines all occur as 
consecutive entries in a vector table that starts at the first memory 
location of the MDDBDG ROM. This vector table is provided as a convenience 
for the user so that the entry-point addresses for MDDBDG ’3 internal 
subroutines will not change from one sub-version of MDDBDG to another. 
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4.1. Summary of Internal Routines and Subroutines. 

The- list below summarizes the internal MJDBOG routines that are 
available for direct access by the systsn's U3er3. The symbolic label 
"ROM" is used here and throughout this document to represent the memory 
address of the first word of the MUEBOG ROM. 


Name 

Entry 

Point 

CRLF 

R0M*-$00 

CRLF4H 

ROM*- $03 

ERROR 

ROM*- $06 

INCHR 

ROM*- $09 

MUDBOG 

R0M*-$0C 

NEWVAL 

RCM+-$0F 

NUMBI 

R0M*-$1 2 

0UT2H 

R0Mt-$15 

0UT2HB 

R0Mt-$l8 

0UT2HS 

R0M*-$1B 

OTT4HS 

R0M*-$1E 

OTTCHR 

RQM+$21 

OUTS 

ROM*- $24 

POWEHUP 

ROM*- $30 

PRTXM 

R0M+$27 

READPT 

ROM*- $2 A 


Function 

Output a CRLF to the terminal . 

Output a CRLF and the four-hextet value of loc3 XR & XR-t-1 . 
Output a backslash and a bell; then return to MBEBUG. 

Input a single character from the keyboard to the AR. 
Return control directly to the top of MUEBUG. 

Read a four-hextet number into locations ZR and XR+i _ 

Read a four-hextet number into the AR (MSB) and BR (LSB) . 
Output the two-hextet hexadecimal value of location XR. 
Output the two-hextet hexadecimal value of the BR. 

Output the two-hextet value of location XR and a space. 
Output four-hextet value of Iocs XR A XR-t-1 and a space. 
Output an ASCII character from the AR to the terminal. 
Output a single blank space to the terminal. 

Restart the system as if from a cold start. 

Print the four-hextet XR value and the value of loc XR. 
Read one character from the tape reader into the AR. 

STAA 0, X; 


STAAB RGM*-$2D 


STAB 1, Xj RTS 
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4.2. Subroutine Descriptions. 

Thi3 section contains interface information for the internal MODBUG 
routines that are available for direct access by the system's users. Each 
routine is briefly described, and then its calling sequence and return 
conditions are documented as may be appropriate. The routines are listed 
in alphabetical order for the convenience of the user. 


Subroutine CRLF; Entry Point = RQM+-$Q0. 

Subroutine CRLF outputs a carriage return and a line feed (CRLF) to 
the user's terminal. 

Calling Sequence: JSR CRLF Output a carriage return and a line 

feed to the terminal. 

Return Condition: Part of the CC value is destroyed, and the AR 

contains a line-feed code ($0A), but the CC.X bit and 
all of the other register values are preserved. 


Subroutine CRLF4H; Entry Point = RGM+-$03* 

Subroutine CRLF4H outputs a CRLF followed by the four-hextet value of 
the two words that are addressed by the XR and XR-t-1 , and the subroutine 
outputs a blank 3pace following the four-hextet value. 

Calling Sequence: LDX = VALUE This example calling sequence show3 

JSR CELF4H how to output the four-hextet value 
from locations VALUE and VALUED. 

Part of the CC value is destroyed, and the AR 
contains an ASCII blank ($20), but the CC.I bit and all 
of the other register values are preserved. 


Return Condition: 
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EHHOR Routine; Entry Point = RQM+$06. 

The ERROR routine outputs a backslash (*\*) and a bell to alert the 
user to some error condition, and then it transfers control to the top of 
MUDBUG with no updating of the pseudo-register values. Notice that the 
ERROR routine is not a subroutine. Instead of returning control to the 
calling program, the ERROR routine transfers control directly to the top of 
MUDBUG. 

Calling Sequence: JMP ERROR N.B. : JMP, not J SR. 

Return Condition: There is no return. Control returns directly to the 

top of MUDBUG. 


Subroutine INCHR; Entry Point = ROM+-$09- 

Subroutine INCHR inputs a single ASCII character from the terminal's 
keyboard through the ACIA (Asynchronous Communications Interface Adapter; 
part number MC6850). Subroutine INCHR returns the input character to. the 
calling routine with zero parity in the AR. Besides returning the input 
character to the calling routine, subroutine INCHR automatically echoes the 
character to the terminal. If the input character is a carriage return, 
however, subroutine INCHR does not echo it to the terminal. This feature 
allows the software to control the position of the cursor on the user’s 
terminal. 

If subroutine INCHR receives an XOFF flow- control, character, the 
subroutine waits until it receives a matching XON flow-control character-. 
Then subroutine INCHR gets the next input character- and returns that input 
character to the calling routine. Subroutine INCHR also ignores any 
extraneous XON characters that it receives, and the subroutine does not 
echo XON or XOFF characters to the terminal. 

Subroutine INCHR doesn't treat XON and XOFF characters as ordinary 
input characters because those flow-control characters can be tr ansm itted 
automatically by many terminals. A terminal can transmit an XOFF character 
to tell MUDBUG to suspend I/O processing, and the terminal can tr ans mit an 
XON character to tell MUDBUG to resume I/O operations. 

Calling Sequence: JSR INCHR Input one character to the AR. 

Return Condition: The AR contains the 7-blt, zero-parity value of the 

Input , character, and the condition codes are set to 
reflect a comparison of the input character against a 
carriage return. The BR, XR, and SP are all preserved, 
and the CC.I bit. is also preserved- ... 

Stack Usage: Subroutine INCHR requires 6 locations of . stack.-..-. 

memory. These 6 stack locations include- the two . 
locations, that, contain the subroutine's return, address- -■ 
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MDDBUG; Entry Point = RQM+$0C. 

Users can return control directly to the top of MJDBOG without 
changing the old values of the pseudo registers by jumping to location 
MUDBUG. This entry point to MUDBDG i3 used when the user wishes to 
terminate execution without generating a register dump. 

Calling Sequence: JMP MDDBUG N.B.: JMP, not JSR. 

Return Condition: There is no return. Control remains in MDDBUG, 

and MUDBUG prompts the user for the next MUDBUG command. 


Subroutine NEWVAL; Entry Point = R0M+-$0F. 

Subroutine NEWVAL reads a 4-hextet hexadecimal number from the user's 
terminal, and the subroutine stores the value of the input- number into the 
locations that are addressed by the XR and XR+-1 . If the input number is 
terminated by a solidus or if the input consists of a termination character 
with no hextets, subroutine NEWVAL doesn' t change the value that i3 already 
in memory. 

Subroutine NEWVAL uses subroutine NUMBI internally, 30 the reader 
should refer to subroutine NUMBI for more details regarding NEWVAL* s 
operation and it3 return conditions. In particular, the documentation for 
subroutine NUMBI explains how subroutine NUMBI sets certain variables to 
provide sane detailed information about the nature of the input number and 
its termination character. 


If the input number is terminated- by a solidus, subroutine NEWVAL 
transfers control directly baclc to the top of MDDBUG. Otherwise, control 
returns to the calling routine. 


Calling Sequence: LDX =VALUE 

JSR NEWVAL 


This example calling sequence shows 
how to read a new value for the double- 
precision number that la in locations 
VALUE and VALUE+-1 . 


Return Condition: 1. Normal return. The AR and the BR contain the new 

(or preserved) value that is in locations XR and XR-t-1 , 
and the other registers (except the CC register) are 
preserved. Location TERMCH is set to reflect the 
termination character that was used. 


2. Solidus terminator- If the input number is 
terminated by a solidus, control goes directly to the 
top of MDDBUG . instead, of returning to the call ing 
routine. -• ---- — 
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Subroutine NUMBI; Entry Point = RCM+ll 2. 

Subroutine NUMBI reads an ASCII-coded hexadecimal number from, the 
terminal y and it returns the 16 least-significant bits of the number's 
value in the AS (most-significant byte) and the BR (least-significant 
byte) . 


The input number must be terminated by one of seven termination 
characters: a period, a comma, an asterisk, a blank space, a tab, a 
solidus (»/*), or a carriage return. A solidus termination character both 
terminates and cancels the input number, so subroutine NUMBI returns the AR 
and the BR unchanged to the calling routine when the user types a solidus 
terminator. The other six termination characters merely terminate the 
input number. 

If the user types a carriage return as the termination character, 
subroutine NUMBI does not echo the carriage return to the user' s terminal. 
This feature allows the calling routine's software to control the position 
of the terminal's carriage or cursor. 

Subroutine NUMBI always leaves a special, easy-to-test termination 
code in location TERMCH (i.e., RAM+-$Q6) to represent the particular 
termination character that terminated the input number. The termination 
codes for the various termination characters are as follows: 


blank = -7 = |F9 - *111 HOOT 

tab = -7 = $F9 = *11111001 

»•» = -5 = |FB = *11111011 

s -3 a *FD = *11111101 
= -1 * IFF *■ *11111111 
"/" = 0 = $00 = *00000000 

<CH> = +13 s. |0D - *00001 lOt 

Besides leaving the termination code in location TERMCH, subroutine 
NUMBI always returns the condition codes reflecting the value that is in 
TERMCH, so the user «in an ploy a conditional branch following a call to 
subroutine NUMBI to determine someth ing about the termination character. 

Subroutine NUMBI allows the user to type leading blank space(s) and/or 
tab(s) with a hex-number input because many users like to insert white 
space at the beginning of an input number for improved readability. No 
leading white space is required, of course, but blanks and tabs are allowed 
until the first hextet of the input number has been typed. Since 
subroutine NUMBI allows the user to type leading blanks and/or leading 
tabs, a user can't use a blank or a tab to terminate an empty (i.e., 
missing) input number. A user who wants to omit an input number entirely 
must type one of the other termination characters to indicate the missing 
number. 


The input number for subroutine NUMBI can be signed. A leading minus 
sign causes subroutine NUMBI to return the two' s ^complement; of the input-- 
number as the input value, and leading plus signs have i no, effect. on- the-.. 
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value of the Input number. Two minus signs (or any even number of minus 
signs) cancel each other, but any odd number of minus signs result in the 
negation of the input value. Leading sign characters are permitted un t-.-t i 
the first hextet of the input number has been typed, and after that t-.ima 
sign characters are rejected as invalid input characters. 

If a user types a leading plus sign, subroutine NUMBI clears location 
PLtJSFLG (i.e., RAM*$2C). -Otherwise, subroutine NUMB I puts a nonzero value 
into location PLOSFLG, so the calling routine can check location PLOSFLG to 
determine whether or not a leading plus sign was typed. 

The terminal operator can correct any typing errors in an input to 
subroutine NUMBI by simply typing a backslash ("V) before the number's 
termination character has been typed. 1 backslash cancels everything that 
has already been typed for the input number and restarts the number from 
its first character. 

The operator can alternatively correct simple typing errors by- taking 
advantage of the fact that subroutine NUMBI retains only the 16 least- 
significant bits of the input number. By simply typing new hertets,- the 
operator effectively shifts old hextets out of the left end of the number. 

If no valid hextet3 (0-9, A-F, or a-f) are input to subroutine NUMBI 
(i.e., if a termination character other than a blank or a tab is typed 
without any valid hextets preceding it) , the subroutine returns the AH and. 
the BB to the calling routine with their original values unchanged. This 
feature allows the calling routine to provide a default value for the input 
number. Additionally, subroutine NUMBI puts a nonnegative value into 
location HEXTETS (i.e., RAM*-$2B) if the subroutine receives an empty 
number. Otherwise, subroutine NUMBI puts a negative value into location 
HEXTETS. 

If subroutine NUMBI receives an invalid character for an input, it 
outputs a bell (ASCII code * $07) and a question mark ("?"; ASCII code = 
$3F). Aside from making these outputs, subroutine NUMBI Ignores the 
invalid input character. Only the following characters are accepted as 
valid inputs by subroutine NUMBI i 

blank tab + - , * . <CR> /0 1 2 3 4 5 6 T 8 9 4 B C D E F a b c d e f \ 

The first two characters in this list (blank and tab) are valid as 
leading characters before the first hextet of the input number has been 
typed, and they are also valid as termination characters after the first 
hextet of the input number has been typed. The next two characters in the 
list (+ and -) are valid only before the first hextet of the input number 
has been typed, and they are rejected as invalid inputs if they are ever 
typed anywhere other than at the beginning of a number. A backslash ( w \*) 
can always be used, to .rest art an input number, so a user can go back and 
type a forgotten 3ign characters by. first typing abackslash."-- -- 

The calling sequence and return conditions for “subroutine- NUMBI are- as 
follows r t 
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Calling Sequence: Typically , JSR NUMB I or BSR NUMB I 

Return Condition: 1. Normal return. The AR-BR contains the double- 

precision input value , and locations TERMCH, FLUSFLG, 
and HEXTETS have all been set as specified above. The 
CC.I bit is preserved, and the other CC bits reflect the 
value of the TERMCH code. All other register- values are 
preserved. 

2. Solidus terminator. The AR and the BR are both 
returned containing their original values, and location 
TERMCH contains the termination code for a solidus 
(i.e., 0). The CC.I bit is preserved, and the other CC 
bits reflect the zero value in TERMCH. All other 
register values are preserved. Location HEXTETS is 
nonnegative to Indicate that no hextets were retained, 
and FLUSFLG is set to indicate whether or not the user 
typed a leading plus sign. 

3. No number input. If no valid hextets are input 
ahead of the termination character, the AR and the BR 
are both returned unchanged, and the special code for 
the termination character is returned in location 
TERMCH. The CC.I bit is preserved, and the other CC 
bits reflect the value of the TERMCH code. All other 
register values are preserved. Location HEXTETS is 
nonnegative to indicate that no hextets were typed, and 
PLUSFLG is set to indicate whether or not the user tyed 
a leading plus sign. 


Subroutine 0UT2Hj Entry Point = R0M*$15. 

Subroutine 0UT2H outputs the two-hextet hexadecimal vailue of the 
memory word that is addressed by the XR. 

Calling Sequence: LDX =VALUE This example calling sequence shows 

JSR 0UT2H how to output the two-hextet vailue from 

location VALUE. 

Return Condition: The AR and part of the CC value are destroyed, but 

all other register values and the CC.I bit are 
preserved. 
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Subroutine CUT2HB ; Entry Point = R0M*$18. 


Subroutine 0UT2HB outputs the two-hextet hexadecimal value of the BR 
to the user's terminal ♦ 


Calling Sequence: LDAB VALUE 

JSR 0UT2HB 


This example cal 11.ng sequence shows 
how to output the two-hextet value that 
is in location VALUE. 


Return Condition: The AR and pant of the CC value are destroyed, but 

the other registers and the CC.I bit are preserved. 


Subroutine 0UT2HS; Entry Point = R0K*-$1B. 

Subroutine 0UT2HS prints the two-hextet hexadecimal value of the 
memory word that is addressed by the IB, and it prints a blank space 
following the two-hextet value. 

Calling Sequence: LUX =VALUE This example calling sequence shows 

JSR 0UT2HS how to print the two-hextet value from 
location VALUE. 

Return Condition: Part of the CC value is destroyed, and the AR 

contains an ASCII blank ($20), but the CC.I bit and all 
of the other register values are preserved. 


Subroutine 0UT4HS; Entry point = RQM*-$1E. 

Subroutine 0UT4HS prints the four-hextet hexadecimal value of the two 
memory words that are addressed by the XR and XR+1 , and it prints a blank 
space following the four-hextet value. 

Calling Sequence: LDX = VALUE This example calling sequence show 3 

JSR 0UT4HS how to output the two-byte value from 
locations VALUE and VALUE-*- 1 . 

Part of the CC value is destroyed, and the AR 
contains an ASCII blank ($20), but the CC.I bit and all 
of the other register values are preserved. 


Return Condition: 
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Subroutine OUTCHR; Entry Point = R0M+-$21. 

Subroutine OtJTCHR outputs a single ASCII character from the AR to the 
ACIA, which is interfaced to the terminal . 


Calling Sequence: JSR OtJTCHR 

Entry Conditions: 

Return Condition: 


Output an ASCII character from the 
AR to the user's terminal - 


The AR contains the ASCII character that is to be 
output. 


Part of the CC value is destroyed, but the CC.I bit 
and all other register values are preserved. 


Subroutine COTS ; Entry Point = RQM+-$24. 

Subroutine OUTS merely prints a blank space at the user's terminal . 

Calling Sequence: JSR OUTS Output one blank space. 

Return Condition: Part of the CC value is destroyed, and the AR 

contains an ASCII blank ($20), but the CC.I bit and all 
of the other register values are preserved. 


POWERUP Routine; Entry Point = RQM*$30. 

Users can transfer control to location POWERUP to restart the MUDBUC 
system as if it were coming up from a cold start. The POWERUP routine 
initializes the system's hardware and MUDBUG’s pseudo-register values,, and 
this same routine is invoked by a restart interrupt (RSI) at power-up time. 

Calling Sequence: JMP POWERUP Restart the system. 

Return Condition: There i3 no return. Control remains in MUEBUG . 
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Subroutine PRTIM; Entry Point = E0M+$27* 

Subroutine PR TIM prints a CRLF and the four-hextet hexadecimal value 
of the IE followed by two blank spaces. Then it prints the two-hextet 
value of the contents of the memory location that is addressed by the IB, 
and finally it prints another blank space. The output format for subrou- 
tine PRTIM is therefore as follows: 

rr mx MM 

Calling Sequence: JSR PRTIM Print the XR and the value of the 

location that is addressed by the ZR. 

Return Condition: Part of the CC value is destroyed, and the AR 

contains an. ASCII blank ($20), but the CC.I bit and all 
of the other register values are preserved. 


Subroutine READPT; Entry Point = ROM* $2 A. 

Subroutine READPT reads a single character from the terminal's tape 
reader. The input character is returned in the AR, and it is not echoed to 
the terminal. 

Calling Sequence:. JSR READPT Read one frame of tape. 

Return Condition: The AR contains the input character, and part of the 

CC value is destroyed. All of the other register values 
and the CC.I bit are preserved. 


Subroutine STAAB; Entry Point = ROM* $ 2D. 

Subroutine STAAB uses indexed addressing to store the values from the 
AR and the - BR into the locations that are addressed by the XR and XR-*1 . 

Cal ling Sequence: JSR STAAB Store the AR and the BR. 

The AR and the BR have been stored, and all registers 
(except the CC register) are preserved. The CC.I bit is 
preserved. 


Return Condition: 
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APPENDIX 

B 

The design specifications for the MC6809 version of the intelligent printer 
controller card. MSFC is currently constructing a printed circuit card to 
implement this design. The software necessary to use this card as a 
controller for a Diablo Hy-Type 2 printer is currently under development 
and will be supplied to the goverment after it is checked out on the 
finished version of this card which is to be supplied to ASU by MSFC. 


Printer Controller PWB 
(6809) 


NOTES : 

(1) The distance from the 3.686 MHz crystal to the MC6809 is 
critical and must be less than 20 mm. Also the two 24 pf caps on 
each leg of the crystal must be within 20 mm of each other, (refer 
to the Motorola Data book for clarification). 

(2) All discrete resistors are 1/4 watt carbon composition. 

(3) Decoupling caps should be added between +5 VDC and 
Ground liberally (1 for every 4 I.C.'s).' 

(4) IC numbers (Ux) should be reassigned per the layout of 
the PWB. Suggest U1 be the upper left hand corner, U2 to its 
right, and so forth. 

(5) It would be nice to have four mounting holes (min 3/16'" 
dia.) located as symmetrical as possible and close to the corners * 

(6) The connections to hex inverters, AND gates, and other 
generic ICTs can be changed during layout as long as the change is 
electrically equivalent.. Gates required to be Schmidt-Triggered 
are marked accordingly and should NOT be replaced by a regular 
totem pole- gate.. Also ensure that open collector gates are not 
used in place of totem pole outputs and vice versa. 
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Parts List 

Printer Controller — 6809 


A. Integrated Circuits (IC's) 


Des^ 

Part- 1 

pins 

Page 

+5 VDC 

Ground 

U1 

MPU — MC6809 

40 

1 

7 

1 

U2 

PIA0 — MC6821 

40 

4 

20 

1 

U3 

PIA1 — MC6821 

40 

4 

20 

1 

U4 

ACIA1 — MC6850 

24 

5 

10,12 

1,23. 

U5 

PROM0 — 2764 

28 

6 

1,26,27,28 

14 

U6 

PR0M1 — 2764 

28 

6 

1,26,27,28 

14 

U7 

74LS138 

16 

2 

16 

4,5,8 

U8 

82S129 

16 

2 

16 

1,8,13,14 

U9 

PTO — MC6840 

28 

2 

14 

1,2,4,5,7,28 

U10 

RAM0 — 2016 

28 

3 

26,28 

14 

Ull 

RAMI — 2016 

28 

3 

26,28 

14 

U12 

RAM2 — 2016 

28 

3 

26,28 

14 

U13 

RAM3 — 2016 

28 

3 

26,28 

14 

U14 

PIA2 — MC6821 

40 

7 

20 

1 

U15 

SW1 — Dip Switch 

16 

2,7 

— 

1,2, 3,4, 5, 6,7,8 

U16 

SW2 — Dip Switch 

16 

7 

— 

1,2, 3, 4, 5, 6, 7 ,8 

U17 

74LS244 

20 

7 

20 

10 

U19 

74LS244 

20 

1 

20 

1,10,19 

U20 

74LS244 

20 

1 

20 

1,10,19 

U21 

74LS14 

14 

1,4 

14 

7 

U22 

74LS14 

14 

. 4,7 

14 

7 

U23 

7404 

14 

1,2 

14 

7 - 

U24 

7410 

14. 

2,4 

14 

7 

U25 

7400 

14 

1 

14 

7 

U26 

7432 

14 

2,7 

14 

7 

U27 

Res. Pack 899-1-lk 

16 

2,4 

16 

— 

U28 

Res . Pack 899-1-lk 

16 , 

i 4,7 

16 

— 

U29 

Res.. Pack 899-1-lk 

16 

7 

16 

— 

U31 

MC1488 

14 

5 

— 

7 

U32 

MC1489A 

14 

5 

14 

7 

U33 

7416 

14 

4 

14 

7 

U34 

7416 

14 

4 

14 

7 

U35 

7416 

14 

4 

14 

7 

U36 

7416 

14 

4 

14 

7 

U37 

ACIA0 — MC6850 

24 

5 

10,12 

1,23 


B. Discrete Components 


Des Part . Page 


R1 

10K Resistor 

1 


R2 

3.3K Resistor 

1 


R3 

3.3K Resistor 

1 


R4 . 

. 3.3IC Resistor 

L 

; ’ 

R5 

3.3K Resistor 

1 


R6 

3.3K Resistor 

1 


R7 

10K Resistor 

5 


R8 

10K Resistor 

5 


Cl 

24pf Cap — Ceramic 

1 


C2 

24p£ Cap — Ceramic 

1 


C3 

1.0uf Cap — Ceramic 

5 


C4 

1.0u£ Cap — Ceramic 

5 


C5 

33uf Cap — Tantalum 

5 . 


D1 

Diode 

1— ( 

C ( 0 

A1 

7812 — +12VDC regulator 

5 ; 

l c 7 


C8r 


. i_. Ca_p — Cer-ou* to- 

3_.® Oa.p — C.<2kt<*-v^' c* 


C. Connectors 

J1 — 50-pin right angle ribbon connector 
J2 — 40-pin right angle ribbon connector 
J3 — 6-pin right angle power connector . 


D- Miscellaneous 

(1) Connector J1 should have the following Ground connections t 
Jl-2,8, 11, 14 ,16, 18, 20, 22, 25, 30, 31, 32,35, 38, 41, 44,47 


E. Spare Gates 

Des Part Spares 


U22 

74LS14 

2 

U23 

7404 

1 

U24 

7410 

1 

U25 

7400 

2 

U26 

7432 

2 

U29 

Resistor Pack 

3 

U36 

7416 

L 
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APPENDIX 

C 

The design specification for a 132 Character by 64 Line intelligent CRT 
display system using a Motorola 6809 MPU. This version also has four pages 
of refresh memory. 
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APPENDIX 

D 

A One-Line Assembler/Dis-Assembler for the MC6800 MPU. This is a feature 
that is currently being added to MUDBUG which will greatly increase it ease 
of use, especially to the in-frequent or casual user. This capability will 
allow an engineer to debug in assembly language rather than machine 
language. 
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tv P 

0 b 1 a ft k 1 i hi 0 . r 

actar 

(s' o r 

•*- - *- 
«. t- i_* 

c h a r 

acter 

( s ) 

or 

0 . r»*r 

■ combi 

nati 

On of ] fa_ f‘i {*■' r 

a r »*j 

tabs i* ? 

tween 


t w o fields* At leas t one c o j u m n or i* *h l i e r* f a * . s is n s c e s s a r > 
be c wee n the n p code field and r f » e o p s “ g r i o f * e « d * j m 

nee ess i tv for w h i f e space d e t w e e n r h e o p e r a n u e i e 1 d a n u l n e 
terminator field defend? on the terminator* 


A comma terminator- tells the One-line Assemoler/ 
Disassembler that it should next process the 1 '.rnst.r u erti o n : a-t 
the same location again. A - carriage return as a terminator 
tells the One— line Assemb! er/Disassembl er to process, the 


next ss^ijsn t is 1 instruction in memory afrir it finish-*; 
processing the curre n t ins t r u c t ion. An ast^n si to r sn 1 n a t o r 
tolls tho One-line Assernb 1 er-'Di sassemb 1 or to process the 
previous sequential instruction in memorv after it finishes 


processing the current instruction 


A pai l*'i .j r .-- 1 ifi in a c • > r 


tolls tho One-lino Assemb I er/Disassembl er to re 


mritr I 


t o t h e 


•. u P >.* r 


HUDBUO after- processing the corf' 


instruction. Final i ■ , a s o 1 i d u s < " ■' " '* v r r "i • : ■ a t n r tolls 1 1 » - 
One-line Assembl or /Disassemb I er to abort processing iy,- 
returning control i mined i ato I to the top of f-'iUDSUO unttioui- 
even finishing the processing for- the current instruction. 


There a re three ontr--. points for call ins the One- line 
Assernb I er/Disassembl or sofrijar e pad- age. On -■ antrv point? 
labeled DISASM? is used as the entr-v point of subroutine 
DTS-ASPl. bubr outino OiSAS.fi translates a -iiacn i no ~ 1 an 3 uase 
instruction to an assorr.b! .--language instruction ana prints 
the assemb 1 ! anguage insti uction on the user s terminal. 


'he other two entr ■ p o i n-i'f - lal-elod A ST : HF<t 


AS-Strl , 


subroutine ASS EM - respect i - 


These tuio subroutines 


assemble assembl ■— language instructions to niacriine codes and 
store those codes into memor-v. Subroutine fisMTER'tt tal-.es 
care .of the terminator of-, the-, input assemb 1 v-1 anguage 
instruction and adjusts the XR to point— to -the location, of 


processed where the next 


the next - instruction to be 


instruction is determined according 


the xnpijr terminator 


Subro 
o f t h 
of ta 

ROM - i 
first 
s i rri i 1 
'I i n e 
comp 1 
a d d r a 
app 1 i 


utine ASSEM> on the other hand? retui ns tne ASCII code 
e terminator in the BR to the calling program instead 
kins care of it. 


The first word of the One— line Assemi:- ! er -''Disassemb i er 
s referred to s i m f* o 1 l c a ! 1 ’• as l o c a 1 1 o n A a 11 ! \ ■ M ? and t n e 
word of the One- line Assemfc. 1 er TO sas s imo'S er RAM is 
art , designated as location AOMRAM . The entire One- 
Ass e m t* 1 e n - IJ l s a s s e Pi i- 1 e r p r o y j a m is to r 1 1 e n i n s 
ete 1 s i- moo 1 1 c fashion? of course? so a ' "I of its memo rv 
s s e s c a ri e a s l ! » be c n a n =? e d to ? u i a n > s p e c 1 a 1 
cation. 


C h a p t e r 


Internal Routine? and Subroutines 


The One-line Assernbl er /Disassemb'i ;r 
incorporates three interna! subroutines- 
subi o urines are p r. t e n c i a 1 ! r u s e f u 1 t o r 
applications- P r os ram me r s who wish ho 
t h r e e 1 n t e r n a ! s u t» » o u 1 1 n e s can s i nr 1 t 
routine! s) from their own prysrams , 


software package 
and these three 
wide van e ta of 
n v o !-. e a rr f o !■ the 

C 5 .il • j <£ r 1 « d 


The list or, the next page summarize? the 
1 i n e A s s e m b 1 e r / Id i s a e s e m b I e p* r o u 1 1 n e s t n a t a r 
the s', sterrr ? users, an d interface characte 
ca ! 1 ing-seauence reguirement s and return 
given tor each subroutine m the page? that 
t h, a t the e n t r *, Faints for t n e available i n t 
al 1 occur' in consecutive 1 orations of a vet 
starts at the first location of the Une- 
IJi sasernbl er Ron, This »ect,,i tat. i ? is 


for- the One-line tts s emb ! er /D i sa? serr<h 1 e 

suorou tines will nor change from one sun -vers 
line As semn 1 er /Di sa s s emh '! er to another. 


internal One 
e avail a. o I e t o 
ristics such a ? 

C O n d 1 1’ 1 O i*i T r± f* <zf 

t o 1 1 on: . No t i ce 
e r n a 1 r o u 1 1 r, e s 
t o r table t h a t 
l l n e Assernbl er ' 
p r o v i ,i e o as a 
pomr addresses 
r " s internal 

ion or t t n e One — 


A 


2.1. Summar of Internal Routines. 

Thief list below summar i zss the internal Owe— 1 ine 
As sernb 1 er/Oi sassemb 1 a r routines that are available for 
'lirert access bv the s .stein s users. fhe Simboiic label 

" AS MR CM" j ? used bars and Thr mjahmj t this document 
represent the memo r > address the first word of the Une— 

1 ine Assemb 1 ar /Di sa ss emh 1 *r s ROM, 


Name 
0 i 3 ASM 


ASM TERM 



Enl rv 

Point Fuuction 


AStiRUMt^O' i Trans 1 ate the machi na 

lansuase instruction 

s tr a. r 1 3 ns in t ha rri a m o r y 

location that is addressee 
b * ( The T R to an ass a m b i i 
lansuase instruction* and 
output the assembl y- 1 ansuase 



i n s i; r u >: 1 1 ■ , n 

to the 

term in a 1 

ASMEUM-t-'SCS 

I r a n s 1 ate 

an 

ass a mb 1 v 


1 a n a u a p a 

lnscru c 

1 1 o n t 


mach i n- i ansuase and s ■. or e 
the mach l na- 1 ansuase 

! nstrurtzoii into nteworv. 
The TP: points to the s=roe--r 
it, e i no r ■ I o ca c i o n ac o o r o i ns t 
the input termi nator upon 
r a t u r n . 

H:~'MP,L , *Mt*SeOAi Transl at e an assenrb 1 

lansuase instruction to 

machine 1 a n s u a a a * and s t * * r a 
the inachi na-1 arisuasa 

instruction into memory. 
The- BR contains the ASCII 
coda of the input terminator- 
upon return. 
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2.2. Subroutine Descriptions 

This section contains interface information tor the 
internal One-line Assemb 1 er /Di sassemb 1 er software package 
routines that are availanle foi direct access hr users. 
Each routine is briefly described’ and then its cal line 
sequence and retui n conditions are documented as ma . he 
a p p r op r i a t e . 


S ijbrout] n e B i 3 ASM; E n t r •<• P n 

'•Subroutine DISASM trans 
instruction whose first hvte i 
addressed br the '<R to assemb 1 
the user's terminal. 


me = ASriPOM+*UO 


lates the inacn i ne-1 ansuaae 
s at the memory location 
language and outputs it to 


l.ENBUF is a 21-b'rte buffer in AC-MRAM. Each bvte of 
LENBUF contains a number that represents tne length of a 
me c h i r. e 1 a n g u a s e instruction. ! h e l e n s t n s of t we n t i* 

consecutive previous! c—pr oc ?ssed instructions can be kept in 
this buffer-’ so subroutine ASMTERM can use LENBUF to 
determine th* address of a previous! i— processed instruction. 
LENPTR is a pointer that points to the location where the 
latest value was stored into the LENBUF area.’ LENPTR. must, 
point to the first word of the LENBUF area— before s'i.rbnout'i ne 
DISASM is called for the first time? and subroutines D15A3M 


and A3MTERM automatically update LENPTR as the-.- process 
instructions. The XR must always contain the address ot the 
instruction to be disassemoled before control enters 
subr o u t i n e D 1 3 ASM . 


S u 0 r o u tine D I S AS M c o n t a 1 n s 
QNEBYTE, T'AJBYTE* TRIBYTE, and 
routines update LENPTR to p.nr.t t 
area- and then they store t- he 
length into the LENBUP ant; v 
updated LENPTR value. These rou 
o f c ommo n i n s t r u c 1 1 o ns- and the t 
entry points into one routine. 


i n s e r n a l r o u 1 1 n e s kn**<ij;ri as 
P C DB /T£ . T h e s -a j. n t e r r,a 1 

a new antrv in the LENBUf 
value of an instruction" s 
that is designated hn the 
tines actual 1 • share a lot 
are a ? f a n r i a ! 1 , d i f t e r e n t 


LENPTR must point to the first word of the uENBUF area 
before subroutine DISARM is called for the first time, out 
the user doesn't need to uFdate the e-Une of LENPTR after 
that because subroutines ‘DISARM and ASM TERM automatical l ■ 
update LENpTR. Tne user car, reinitialise i CNPTF; whsnevai 

Ii 

she or he wishes to start processing a new group o 
instructions. Subroutines ASMTERM and ASSEM store a special 
sentinel value into location LENBUP to mart the beginning of 
the LENBUF table? and the first word in the LE.NBUF table is 


therefore not used to contain. the- Length of an instruction.- 


Subroutine BISASM outputs "FCB $hh “ on the user's 


terminal if th 

e o perat i ns c o d e 

that is 

addressed bv the XR 

i s an 

i rival i d 

code. The * h h 

value represents the invalid 

operating code 

■ 



Ca 1 1 i ns 

o ^'j‘3 n 

m 




LDX 

=LENBUF or 

LLU 

=LENt!UF 


C - r v 

5 S' 

LENf-'TR 

'-.TV 

LLNR rc 


LDX 

—Copcode address 

LDX 

— '.opco-ie address! 


•JSR 

DISARM 

BCR 

D 1 SASM 

Re t u r n 

Condi ti 

on: The XR 

contains 

the adorj's f the 


ne it oper ating code? and the CC resistor 
is destro reo- but a!! other resistors are 


pr e served . 

The value of 

LENPfR has h 

a a n 

i n c p c* m n £ '5 d 

? a n d the 

Vd. 1 U<£ 0 

th? 

instruct i o n 

•' s length has 

b '~f '5 i'i *5 t 0 P <? d 1 

nto 

the LENBUF 

entrv that is 

•1 O U* G S 1 3 T I a P £ d 

b*» 

LEflPTR. A 1 

so*’ *r h e v a r i s r* 

i a L NL.UL. hii^ u 

? '5 ff 

set t o p o i n 

t to the instr 

ijction that 

ua s 

processed. 





Subroutine ASM TERM; Entrv Point = ASMRcM+SOc: 

Subroutine ASM TERM translates an assembly*: 1 ansuase 
instruction to machine code and stores the machine code into 


memory star-tin? at the location to ururh INLOC points. 
Subroutine ASM TERM adjusts the XR to point to the location 
of the next instruction to be processed where tne next 
instruction is determined according to the terminator of the 
input assemb 1 v — 1 ansuase instruction, 1 NLLL i ; a two-bite 


memory 'location m ASMRAM. It contains the 


- a I u e o f 


address' where the input assemb 1 v- 1 ansnaae instruction - ; 
machine codes should so. The value or INLOC f-ai - been set b. 


f o 1 1 owing a ca i 1 to subr ,- *uti ne IjI';*ABMi 


Subroutine ASMTERM processes the input assemb; . -- 
I ansuase instruction and updates the lE NBUF er, rrv that , .s 
addressed b-« LENRT'R. LENP l'R points to the location that 
contains the length value of tne assemc. 1 -i ansuase 
instruction that was just d i ? p 1 aved bv subroutine OtSASM. 


Subroutine ASMTERM cal 


• uh routine PTRAftJ to decrement tbs 


value of lENPTR b.- one* and then subroutine ASM TERM call; 


s u h t o u tine ONE BY IF 


TUG BY ft or fPiBYsF or ff.DHYl 


d e p e n d ins o n t h e me m o r si: 


u i one 


machine code for toe 


input as semb 1 r- 1 ansuase instruction to update the LENBU^ 


entry. The reason for call in? subroutine P i'RAD-.l first 

before call in? subroutine ONEBYTE or TWOByTE or TRIBYTE or 
FCBBYTE is that, subroutines ONEBYTE » TWOBY TE?^ TRIBYTEj and 
FCDBYTE increment the value of. LENF'TR — bv— cove. in order 


point to next available location .in the LENBUF area and then 


4 J t 


J. J- 


store the value of the machine-! a n s u a g e instruction's length 
into that location. The lensth value of the assembly— 
language instruction that was processed bv subroutine DISASM 
is overwritten bv the length value of the new assemble — 
language instruction that was jusr assembled bv subroutine 
ASMTERM . 


Subroutine ASMTERM updacc-s the value 
according to the input assewb 1 •. — 1 ar.suase ins 
terminator. Since subroutine- ASM fERM is designed 
with subroutine DISASM’ the value of LfcNPTR that 
s u b r out; n e ASMTERM m u s t rna t c h the l uh ' ci o n o f 


ot LEM.-' ! F< 
t r i i c 1 1 o n ' s 


to be u 


is set in 


s u d r o utiri e 


D I S ASM . 


When the terminator of the input ass emis 1 r- l ansuase 
instruction is a carriage— return terminator, the value of 
LENPTR is unchanged but the value of tne LENBUF er.trv that 


subroutine DISASM disassembles the r-e t mac hi r.e-l anpuage 
instruction to an assemhl .- — language instruction and stores 
the value of the machine-language instruction s length into 
the r.e.--'t available entry in the LENBUF area. 


When the terminator of the input assembly— 1 anguage 
instruction is a comma terminator, the values— of LENP TR - i s 

one after the value of the LENBUF- entry that 


decremented by 
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was originally designated by LENP1 R has been updated. Later 
on? subroutine DISASM disassembles the machine-language 
instruction that is in the same mernorr location addressed by 
the XR to an assembl y— 1 anguage instruction and stores the 
value oh the machine- 1 anguage instruction's length into the 


same entry m the LENBIJF ar;a 


addressed bn LENPTR fc e f r e 


h«? V«3. ! 


decremented h **» one 



When the terminator of the input assemb 1 v-l ansuage 
instruction is a period terminator » the value* of "LENPTR is - 
unchanged but the value of the LEN6UF- — entry that i-s 


designated by LENPTR has been updated 


When the terminator 


o f the 


input 


assemb 1 v— I ansuase 


instruction is a solidus terminator * the value of LENPTR is 
unchanged* and the value of the LENBUF entrv that is 
designated bv LENPTR is not changed* either. 


the t e r m 1 n a t o r is 
AS PI TERM is called alone. We still set the correct returned 


value of the X: 

< when the terminator r 

s a 

car r i a s e 

r e t u r n 

o r 

■‘-‘I c omma - b u t 

the r e t u r - n e d v a 1 u e 

of 

the XR 

w i 1 1 

be 

u n p r e d i c t a b i e 

w h e n t h e t e r m i n a t o r 

is an 

a s ter i s 

. T 

h i s 

problem occurs 

because we have no 

idea 

a d o u t t h e 

val ue 

of 


the previous instruction - s lensti 


If 

LENPTR 

reachs s t J - i e 

e n d o f 

the LENBUF 

area* the 

length 

val ue s to 

red in the se 

cond 

1 o c a t i o n o f 

the 21 -forte 

b u f f e r 

is swept 

out and the re 

s t of 

the values s 

to red in the 

LENBUF 

table a r e 

moved up one 

1 o c a. t i 

on- so e. new 

val ue -ran 


be stored at the end of the buffer area. 

An error message- "INVALID: i*he whole input 
instruction string"- will toe printed on the user's terminal 
when the assemb 1 v—1 anguage instruction is incorrect. 
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Calling Sequence! 

1. General Calling: 


LDX 

=<addressl:- or 

LDX 

=Caddress> 

STX 

INLOC 


STX 

INLOC 

JSR 

ASM! ERM 


ESR 

ASM f ERM 

2. Call 

uj i t h s u b r 

out me DISAS 

M: 


i p V" 

•-LENBUF 

or 

L'jy 

=LENBUF 

STX 

LENPTR 


STX 

LENPTR 

LDX 

= : 'I o p c o d e 

address > 

LDX 

= • o p c o d e ad d res ; 't 

JSR 

D C3ASM 


BSR 

D I SASM 

JSR 

ASMTERM 


BSR 

ASMTERM 

Return Condit 

i n : 




1 . Norm 

a l return. 

The XR cofi 

tai ns 

the address of the 


next 

mstructio n 

to be 

processed where the 


next 

l n s t r u c 1 1 o n 

1 s 

determined accord ins 


t n the term! nator of the input 
instruction. The C'C register is 


lies? 

r ore d 7 

hut 

ali nth e r r 

eg is tars a r e 

pres 

e rve d . 

The 

value of the 

instructi o n s 

lens 

4* L, K a - 

•- J i J 1 rt 

bee 

n s t o red i n f o 

the LEMBUF 

en tr 

J 1 Id. L 

uja ? 

designated b y 

the original 


LENP I R value 7 and LENPTR has been updated 
according to then terminator. 
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Solidus terminator. If the input assemb 1 y— 1 ansuase 
instruction is terminated by a sol idusi 
the value of the memory location addressed 
bv the XR is unchanged and control goes 
directly to the top of MUD BUG instead of 
returning to the calling routine. The 
value of the L ENDUP entrr that is 

designated bv LENP TP is unchanged' and 
LENPTR is unchanged j too. 

Period terminator. If the input assemhl t — language 
instruction is terminated b a period? the 
value of the memory location addressed by 

J 

the XR is updated and control goes 
directly to the top of MIJDBUG instead of 
returning, to the calling routine. The 

value of the instruction's length has been 
stored into the LENBUF entry that is 
designated bv LEiMPfR? and LENPTR is 
u n c h a n g e d . 

Error return. The XR contains the value of INt.GC 
and the CC register is destroyed* but all 
other registers are preserved. The value 
of the memory location addressed by the- XR- 
is unchanged. The r value of the LENBUF 
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entry- that 

i s 

de s i 

gnated b 

LENPTR 

i s 

unchanged , 

T ft ft . 

T he 

value of 

LENPTR 

i s 

decremented 

by 

one 

Just as 

if a c 

omrna 


terminator had been used. 

Subroutine ASSEM; Entry Pmnr = ASMf?0M<-$rt6 

Subroutine ASS EM is similar to sure nut 1 ne ASMTEKM. It 
translates an assemb 1 y— 1 anguage instruction to machine code 
and stores the equivalent mach i ne- ! ansuas s instruction into 
memory starting at the location that is adds eased by the XR. 
Subroutine ASSEM returns the ASCII code of the input 
instruct inn - ' s terminator in the SR to the calling program. 
When subroutine ASSEM is called, the XR must contain the 
value of the address at which the machine-language 

instruction is to be stored. 

An error message^ "INVALID: the whole input 

instruction string", will be output to the use' - - terminal 
when the input assembly-1 anguage instruction is incorrect. 

Calling Sequence: 

LDX =<address> or l.DX =caddrassD 

, .JSR ASSEM 


BSR 


ASSEM 


Normal return 


The XR contains khe memo r-- address 
of the location that immediate 1 follows 
the new instruction in memory when the 
terminator is a carriage return' a comma? 
an asterisk- or a periods The value of 
the XP is unchanged when the terminator is 
a solidus. The BP contains the AST i I code 
of the input instruction s tern.inator ' ana 
the OC register is destroyed? but al 1 
other resisters are preserved. Ihe value 
of the memory location addressed b r the 
previous XR is updated when the terminator 
is a carriage return, a comma? an 
asterisk » or a period. The value of the 

memory location addressed tv the original 

v 

XR value is unchanged when the terminator 
is a solidus. 

Error return. The CC register is d.-sti-o red ? hut 
all other register- values are preserved. 
The value of the memor •- location addressed 
br r he XR is unchanged. 


Chapter 3 


The One-line Assembler Source Svntau. 
Expressions, and Pseudo Instructions 

3.1, One-line Assembler Source S m ca-: 

A source line in the Oie-hn* Assembler's assembl r 
language man contain up to rf.rea f l e l d = : an opcode field. 


an operand 

field. 

an d 

a 

tanruna 

t o r field. 

3 l nee the 

One- 

line assembl 

1 er mat 

as 

no 

c o n n — c 

tlon from 

one source 1 , 

n e f o 

an .other ■> no 

svmbo 1 

t a b 

i e 

is *3 s t 

ab 1 is hed , 

and labels ar 

e r. o t 


accepted. A typical source line thaf is t.ped at a terminal 
general lv loots lile this: 

LDAA Oi X -.CRI 

o p c o d e o pe r a n d t a r m j n a f n r 
f i s 1 d field f i a 1 d 


The 

0 n e - 1 

me As 

semi:. 

i a r a 1 1 o w s 

th- us 

e r t 


tv 

P<=i 1 

e a d i n y 

b 1 a n t ( s ) 

and/ 

r t a b ( 

s 1 w 

1 1 h a so u r r e 

1 me 

l npti 

X 


»” O.U b 

e man 

users 1 i 

te to 

l n s e r t 

wh i 

te space at 

tn a 

bey 

1 n 

n ins 

of ao 

input s 

o u r c. e 

1 i ne 

for 

i riipr ova d 

r e a d a b 

, i , 4 
i i i c 

‘i - 


No 1 

ead i ns 

white s 

pace 

is require 

d, of course 

, but 

w h 

l t 


s pa 

c e is 

al 1 owed 

until 

f he t 

i r st 

n c. n wh i t e 

c h a r a 

c t e i 

o 

f 

the 

s o u r c e 

1 ine has 

been 

typed . 

Th 

e first fiel 

d o f 

a 

tv 

pi 

cal 

s o u r c e 


line is the opcode field, incl it roust contain- one- of the 
•valid M6S00 opcode or pseudo— opcode mnemonics. (See the 


M6300 Programming Reference Manual for the opcodesi and see 
section 3 of this chapter- for- the pseudo opcodes' 
descriptions.) Some of the opcodes require an "A" or "8" 


ten si on 

(e.g., BIT 

or CMP) while 

other 

opcodes permit 

the 

li . _ n r~i n 

P o 

e:-tens l on 

(e.s. - RGL o r 

Ask ) - 

and 

still o 

t h e r 

c 0 1 j 5* 'd O 

n o t pe<- rn i 

t anv e:- tension 

(e.g.. 

I NX or 

BLE ) . 



The opcode field mav he terminated fc ■ one or more 
blanks and/or tabs. Most programmers use a single tab to 
advance to the operand field of the instruction. There are, 
however- some instructions that do not need an operand 


f i e 1 d , a n d 

for 

t h <* s e 

instructions the 

o p c 

o d e 

fie 

1 d 

mar 

he 

terminated 

bv 

o ri e o f 

the four terminat 

or-s 


or 

i> l) 

■ 

or 


o r " / " ) 

ui 1 1 h 

at 1 

east one leading b 

lan k 

o r 

tab 

or 

ma 

he 


terminated br a carriage return with or without leading 
white space. A carriage return terminates the entire source 
1 i ne . 

The second field of an instruction line is the operand 
field, which natural 1 < contains the operand for the 
instruction. Most instructions require at least a simple 
operand field <e.s., 3TX SAM), while other instructions 
require or allow two subfields in the operand field (e.s., 
LDAA -3, X or STAB .. 0,X).- - Some instructions permit, 
multiple operand-field entries ■ (e.g., FCB. . and FpB). 


Final 1 Yi there? are some instructions (such as INX and DEX) 
that do not require any operand field at all. 

If an operand field contains two or more subfields* one 
or more blanks and/or tabs ma-.- occur- after the comma that 
terminates one subfield and before the beginning of the ne:.t 
subfield. This rule makes the One-line Assembler source 
syntax compatible with a standard typing rule chat requires 
a blank space after- a comma. 

The operand field can be terminated bv one or more 
blank spaces and/or tab character s (except after- a comma!. 
Most users type a single blank space to skip to the 
terminator field when the terminator is one of the four 
nonblank terminators (”*" or or or "/"!. The user- 

can type a carriage return without an t leading white space 
to terminate both the operand field and the entire source 
line with a carriage-return terminator. 

3.2. One- line Assembler Express 1 ons 

The One— line Assembler evaluates expressions that are 
found in the operand field. A simple operand field contains 
only one expression* but an operand field ..with subfieTdS; 
contains an expression in. each -subf i-el d-. fin- expression. 


consists of a term or multiple terms connected by operators 


and an expression can include any of the following types of 
terms ‘ 


1. Decimal number. Anv series of disits (0—9) 
starting with a nonzero digit is recognized as a decimal 
number. The value must be unsisneo and in the range l 
through 65-535 (i.e.? an unsigned 16— bit value). 


2. Octal number. An. series of octets (0-9) starting 
with a zero is interpreted as an octal number. Octal 
numbers are permitted to occupy as marry as 16 bits 
(including the sign bit) because users sometimes find it 
convenient to code 16-bit constants as octal values. 



O • 

Binary 

n u m bar. 

A 


" prefix charac 

ter followed by 

a ser 

les 

of bits 

(Os and 


Is i 

is recognize 

d rx 3 

a binar v 

n u m b e 

r . 

Binary 

n u m b e r s c 

an 

be 

as large as 16 

bits- 

so users 


can specify full 16— bit values m binary if they are 
i n c 1 i n e d . 


4. Hexadecimal number. A series of hextets <0-9, A-F, 
or a-f) that is prefixed with a "5" is interpreted as a 
hexadecimal (hex) number. Hex numbers- like numbers m 
other bases- can. contain as many as 16 bits*- -so a hex: va.l ue 


can contain as many as- four hexte.ts 



5. Present— 1 ocat ion symbol. When an asterisk ("*“) is 
used as a term* it represents the value of the asseint* 1 er - s 
location counter, which is always updated as the last order 
of business when an instruction is assembled. The value of 
the present-location symbol therefore equals the address of 
the current instruction. and for a two-word or three-word 
instruction the value of is the address of the first 

word of the instruction. Most users of ordinary two-pass 
assemblers tend to avoid us i ns the presen t — 1 oca t ion srmbol 
except in special circumstances since the use of or 

“•a~" is an extreme 1 y poor prosrammin? practice. For 
example. an . one who codes an instruction such as JMF fc+5 is 
making his or her program hard to read and hard to maintain. 
If arrv intervening code is inserted (or- deleted) after the 
JMF' -*+5 and before the target address of the jump- the 
program will no 1 onser operate correct ! v. However, since 
the One-line Assembler cannot accept labels- "<-r" and 
addressins is useful during debugging sessions. 


Sinsle A'dCII character. A single ASCII character 


encl o s e d b v o r 

p p c ■€? o 'j? ci 

b r a p o s t r o p h e s 

or quotation ma 

*• l, #- 
I r- 

( e . g . . " A ' - " A" . 

-A, 

or "A) 

mar be -use 

>1 as a term. 

T n e 

value that is 

s ^ n p 3. tr d 

for the quoted 

character is 

the 

eight-bit ASCII 

code 

for 

the character 

with, „the_ parity 

bit 


reset 


The terms of an expression are combined (us ins 16— bit 
operations) according to the expression's binary operators 
m 1 ef t— to— r isht order with all operators having esual 
precedence-. and the following binary operators are 
r e c o snized! 


Add i 1 3 on 

S u b t r a c 1 1 o n 

M u 1 1 1 p 1 l c a t i o n 

Integer Division 

Logical AND 

Logical Inclusive UR 

Logical Exclusive OR 

Larger of Two Signed Terms 

Smaller of Two Signed Terms 

Larger of Two Unsigned Terms 

Snial ier of Two Unsigned Terms 

Logical Shift Right (Zero Fill) 

Arithmetic S h l f t Right < S i s n F 1 1 1 ) 

Rotate R 1 3 n t 

Arithmetic Shift weft 

Rotate Left 


Additionally, a single unary operator or mar 

appear at the beginning of an expression. and the unary 
operator will be a p p i i e d t o the first term o i the 

e -:pres s i on . 


Note that the assembler can tell by the svnta.. of an 
expression if an asterisk ( “*" ) is being used to denote 
multiplication or the present-location symbol. 


The One-line Assembler computes the- -value — of — an 
expression from left to right with egual precedence for all 


/ 

. AND. 

, OR . 
. XOR . 
. MAX . 
. MIN. 

. HI . 
. Lots. . 
. LSR. 
. ASR. 
. RUR . 
. ASL. 
. ROL . 


I 


O P e P a t O P S 


For 


f he 


ex press i on 


example? 

evaluates to ,, 9/2-4*3“? then to “4-4*3“, then 


' 4 f‘5/ 2-4*3" 


final 1 y to zero. Notice that integer division is performed, 
and the remainder. if any- is discarded. Since an 
expression is evaluated from left to right- Parentheses are 
not meaningful and are not allowed in an expression. 


3.3. One- line Assembler Pseudo Instructions 

Like most assemblers- the One-line Assembler recognizes 
some pseudo instructions. Pseudo instructions? which are 
s o me t i me s cal led a s s e m d i e **■ d i r e c 1 1 ve s - d o n t u s u a 1 1 r 

correspond to machine-language instructions on a one-to-one 
basis as normal asserr.D 1 r-i ansuage insti ucti *-n= go. Instead- 
a pseudo instruction ma , tell the assembler to take some 
action? so the user directs tne assembler s operation 
through the use of pseudo instructions, five remainder of 

t h i s sec t i on contains c e s c r i p 1 1 o n s of the various p s e u o •> 
i n s t r* u c 1 1 o n s . 


FOB. The FCB (Form Constant Bate) instruction tells 
the assembler to evaluate the operand e.-Fression into an 3- 
bit value and to generate an object wore tnat contains tne 
3-bit value of the expression. ,Th.e FCB instruction is thus 
used for creatins constant values -that can be accessed bv 
program at execution time. If the value 


the 


of an F CB 


itr 


expression field doos not fit properl v into a bits* the 
assembler reports an error messase. 


The FCB instruction permits multiple expression fields 
separated bv* commas? and each e p r s s s 1 ^ n f lei n seneraires one 
word of object code. The location counter is advanced after- 


each expression field of an FCB statement is 


'hereto re- trie 


neat i on-coun ter svmoo 


1 uated. 


i J“l '-i J*} j“ L 13 


instruction alu«avs refers to tha memor-i address of th=? word 
that is oeins senerated bn- the expression that contains the 
location-counter svmbol . 


FCC. 

The FCC 

( F o f m C o n 

stant Characters) 

i n s 1 r- ucti o n 

tells the 

assernb 1 er- 

that t 

h e o ps r a n d f i e i d 

c o m r i j 5 *3. 

character 

st r i n 3 . 

The s cr i 

,’i s m u s t r e e n c I os e d 

t ruio 


identical delimiters? each bems a smsie nonblank prinfaole 
c h a r a c t e r . 


The f u 1 1 out ins ;• amp i .-s 
with the FCC instruction: 




IU i * ? 


" T r i- ever 1 1, i n s >• o u can . “ 

'.‘Does John so wi <~ h us •' 

WIf music be the food of love? plan on.w 
D ! ( ) _«•+ Try tr r trr so so hope you .win !.! ID 


The FCC statement generate 
character of the string 
delimiters? of c o u r s e ) . T h e 
generate character strings 
programmers for outputting mess 


s one object uiord for each 
(not including the string 
FCC statement is used to 
that are normally used by 
ages o r o e a d ins s a t e i- e cun o r i 


. rriv 


A 1 t h o u s h a 1 1 » i i c« rt h ' a j i r c n a r a c t e r 


delimiter? most programmers use quotation marks ( 11 ) as 
string delimiters* A p r o s r enre u* n o ii'isne? i o include a 

quotation mark as a character of the string ordinarily uses 
apostrophes (1 as string delimiters'. A user u»ho wishes to 
include both quotation marrs and apostrophes in a string 
usual In chooses some other special character (such as '? $? 
*/., ;’■< ? =, ;? +? <•- -? / ? or > as a string delimiter. 


The One-line Assembler carefully examines the string 
that appear s with an fee* statement? a n * 1 it r e p r t s an error 
l +■ anything appears to h- amiss with the string. i'or 
example? the Cine- 1 me Assembler reports an error i s : a 
n >:> n d 1 a n 1 character i mme d i a t e 1 * f o 1 1 o ur - the closing string 
del i m iter because the user probably- tried to use the string 
delimiter as a character in the string m this case. The 
One-line Assembler also reports an error i f- i t ■ never _ finds 
the closing string delimiter? and it simi-Ur-Tf .rapocts an. 


error it 


the string is empty. 


FDB. The FOB (Form Double Constant Byte ) instruction 
is similar to the FCB 1 nstr uct 1 on •> but the FDB instruction 
generates a 16— bit constant that forms t>uo consecutive 


object words. The most— significant half 


the 16-bit 


express 1 on va 1 us is put into the first object word’ and the 
1 east-sisni fi cant half of the 16-bit e-.piession value is Fut 
into the second object word. 


The FDB instruction tells the One— fine Assembler to 


generate two object words that contain the l6--bit value of 


: he e • • f r e s s i o n 


The FDB instr 


U >- 1 1 '.Ml 


thus used for 


generating doub 1 e-prec l s i or, constant values that can 
accessed bv the program at e - ecu t ion time. 


The FDB instruction permits multiple e -.ft ess ion fie las 


separated b> commas- and each expression 


d generates t w o 


w o r d s o f o b i e c t c o g e ■ i h e I o c a t ion counter is a d v u. n c e d 
after each e pression Field of an FOB statement js 
e va 1 u a t e d . The r -e f o re, t h e 1 o c a 1 1 o n — c o u r. ter s rrr, b o i < 11 *" > i n 
an FDB instruction alwars refers to the memory address of 
the first word that is being generated bi the e: pression 
that contains the location-counter symbol. 


line Assembler to generate a one-word instruction that will 


skip the next one-word instruction during execution of the 
assembled (user's) program. By employing this instruction 
(as opposed to a branch instruction) the programmer will 
save one word of memory. For example , the following 
instruction sequences execute the same wa - but tne code on 
the right uses one less wo; d of memory: 

BRA 1 i- 

DEC'X DEX DEC X 
1H ST A A 0, X 

The generated opcode value ($85) for the St 1 
instruction is the same value that is generated for the 
first word of a two-word BITA instruction with immediate 
addressing. When the Ski instruction is executed' 
therefore* the microprocessor- takes the following word as 


t h e sec o n u 

word 

o f 

a BITA 

i n sir 

U C t JL O n W 1 t h 


ad d r e s s s l ns . 

The 

ne t 

effect is 

to ?k 

i p one word. 

rd 3 ti r 1 d 'd 


effect, the Ski instruction mat mod if- toe :\j bit- the l nit, 
and the V bit of the condition cooes. 

SK2. The SK2 (Skip 2 words) instruction tails the 
assembler to generate a one-word instruction that causes tne 
next two memory words to be skipped at execution time. 
Similar to the SKI instruction,, the SK2 instruction 


DEX 

S f A A 0, x 


saves- 


the programmer one word of memo r v . For example? the 

following instruction sequences execute the same war* but 
the code on the right uses one less word of memory: 

BP A 

LOOP ADDS 
1H STAB 


IF Si-' 2 

=4. LOUP ADDS -'4 

L 7 X 8"i AB L ? X 


The opcode value ($80 that is generated for the ':K2 
instruction is the same value that is generated for the 
first word of a three-word CPX instruction with immediate 
addressing. When the SK2 instruction is executed? 
therefore? the microprocessor takes the following two words 
as the second and third words of a CPX instruction with 
immediate addressing. The net effect is to skip two words. 
The SK2 instruction mar therefore he used to skip two 
single-word instructions or one dour 1 e— wor d instruction 
during program execution. As a side effect’ the 8k 2 


instruction man motif . tr.e N 


the C bit o t- the c o n d i t i o n c o d e s . 


Chapte r 


A 


Une-l ini Di sassemo i jp S.'i'ita:-. 


The One-line Assembler translates each source line into 
the proper I v l6y0u machine language coos and 5 1 o i ■ ? £ 1 c into 

mernorv on a 1 i ne-b ■— 1 i n e basis at me cure u *■ er.fr in 
o r d e r to cl i s p 1 a r an i n £ t r u c t i ri n ? 1 1 * e ma c n i n e code m u s t he 

d i s a s s e m b 1 e d ■> and t n . ^ i n s t r * j c 1 1 o n r* e r»*o n i c and ... p *-* r r-. n c s a r a 
d 3 s p ! a f e d . T h o s a j o o s •* g i s a s s e m d 1 i n 3 ma c h i n e “ones a n o 


d ispUvins instruction mnemom ; and vper n±r,ds < ar a done bv 
the One-line Di = a ssemo l er . 


The u n e — 1 me Disassembler i n c r s a s o s 


when 

t h e u s 

e r c h e 

•I r* 5 

h 3. s 

o r 

h e r p r 

d i sas 

semb 1 ed 

s o u r C r 

1 i n e 

n’ , 0.*i n 

ot 

■» h i ’I* >X 5 ■& V 'r 

the 

s o i j r c e 

1 i ne t 

hat 

was 

or 

is i na i 1 

l n s t r 

ucti n n . 

The 

d 1 55. 

ssembl 

£ r 

a i wa .'S 

val ue 

s in he... 

a decimal 

seeded 

b 

. — U it 

I *rL 


LDX 

3+t»-p* 

A • 

— r » *- ■» 

V 

/' 




d l s a s s e in b I e s t o 

LDX $10, X 


mosram readability 
si am in me mo i‘ r . Tne 
r - 1 o o T i den t i ca ! t o 

e n ter s c +• o r t h e 
outputs numerical 

si an. h o r s: :a«iP 1 >3 ’ 


The disassembler cannot output labels. it outputs the 
value of a label instead of the character .stn ns of> the.: 

label. For example, the following source - 1 ine - ls-assemt. Tea-- - 

bv the M6300 assembler on the VAX: 


STX SAVEX The address of SAVEX is $108, 

This instruction disassembles to 
STX $103 

When an instruction uses the se i t-r '! at ± v-= addressing 
mode? the d i s a s s e m o 1 e r d i s r i a * - 5 ti*e a. c t u <?*. ! n e .a d e c 1 r**a * 
address of the destination instead of disFianns the 
d i s f 1 a c e me n t oetween this instruct ion and fne tarsec 
address. For- example? the following source line is 
assemb 1 eu o .** the PtoSOO assemb i er ‘in the 1 • A / - 

BRA LOOP The address of LOOP is $1200 

This instruction disassembles to 
BRA $1200 

Also? for some instructions? there are two valid 
mnemonics for the same o Herat 1 r. a code? and the disassembler 
mar choose a form different from, the one or is ■* r.al 1 entered. 
For examp 1 e? 


b. 

CP X 

mi 

t h 1 filmed 1 a 

t e 

a d a 1 essirg 

1 5 

ret 11 

I n e d f 0 r 


SK2 . 








c . 

BCG 

1 s 

. returned 

for 

BHS. 




d. 

BOS 

1 s 

r e turned 

1 0 r 

blo . 



- 


A n y i n va 1 id M 60 OO o pe r a 1 1 n s c o do uj 1 11 be Jispla,- e d 1 n 


the fol 1 outins wav: "FCB $Cmachine coae> 

FCC “ABODE" 


‘ for examp I e. 


disassembles to 


FCB 

$41 

FCB 

$42 

COMA 


LBRA 


FCB 

$45 


B 1 n c e 

tne One-1 

me LJi 

se s semb let 15 

0 f t e n 

* J 5 

e d u.i 1 - h 

t he 

0 n e — 1 1 n e As 

s e m fc 1 e r - u 

'5 5 r« 0 » j 

Id e_-.pe.-i.all-,- 

n 0 t e 

0 ft '=? 

P P Cl ‘Z ! J 

1 ar 

s 1 1 uat 1 on . 

Suppose 

4- L - n*- 
liln. 

the user t 

1 p<; s 

The 

1- 0 1 1 :u 

ms 


instruction as an input bo Lv.e One- line Assemo 1 er : 
Fi'B 1,2, 3-4 


The mstructi 0 n 

1 ensth 

F 0 1 t n 1 s p s e u d 0 

1 n s t r 

u c 1 1 0 r. is 

four bvtes. The va i 

ije f 0 u r 

i. s therefore st 

0 r e d 

i n 1 0 t h e 

LENBUF area after oh 

is hs e * i ■ i 

0 1 nr.tr u c c 1 or. has 

b e e 0 

p r 0 .* e s 5 e d 

bv the Une -1 me Ass 

err.t 1 e r . 

Suppose that the 

user 

c 0 n b 1 n u e s 


to i Pi p u t n e uj a ? 3 e m b 1 *v 1 a n s u a. s? e instructions or t o c h e c k hi s 
or her program at subsequent locations in a forward 
direction. Later on, the user uses asterisk ) 

terminators to .back up to this psaudo instruction,- arrd- a- NOP - 
assemb 1 r -1 ansuase instruction is d i sf 1 aved... _a.t tne - user 's- - - 


terminal 


This NOP instruction appears because tne value 


$01 > which is the 


of the four— brte 


value of the first bvte 
FCB instruction! is the opcode for- a N'JF* instruction. The 
One— line Disassembler sees the $01 and assumes that it is 
the opcode of a NOP assemb 1 v-1 ansuase instruction. The user 
c a n c 6 n t i n u e t o c h e c k t h e c o n t e n t s of the FCB ? s e u d 
instruction's me morn locations bi t •> i n s car ruse- retur n 
ter m i uators . 

The FCB l-2»3,4 

disassembles to 


NUP 




FCB 

$02 



FCB 

$03 



c r-p 

$04 



The O n e — 

line Disassemol 

er is a ve r c 

useful deoussins 

too 1 i but the 

user still n 

eeds to nave 

a clear idea aoout 

his or her own 

pr (.erijTi , F o r 

~ *5. rri f 1 ■>£?■» cl 

user who tries to 

disassemble a 

string of ACC i 

x C:ial i’. cn 

ui ! 1 on 1 v create 


c o nhusi o n 


Chapter 


The Application of the One-line 
Assemb 1 er /Di sassemo 1 er in MUDBUG 


As men tioned in h* n a p t e r i > in 1 3 o n line n s s e m o 1 e r / 
Disassembler software pachas-? is designee for MODbbU to 
increase the functionality of certain ftwDBUG commands. when 
a source program is assemo (eci and o o w n 1 oaoed to memor r, wnat 

the user sees in memor-v is toe machine 1 d.ns uese version of 

\ 

the program. it is sometimes difficult foi the user to 
understand and debug his or her program in machine lansuase. 


B‘> using 


mis 0 n e 


1 i i re 


Ass emti er/ bi sas serno 1 er software 


pad-age, the user can inspect his or her program in memory 
and change the program by simply typing as = amb 1 - 1 ansuage 
instructions direct!. • instead of typing machine codes. The 
following two sections describe the application of the One- 
line Assemb 1 er/Di sassemb 1 er in the memor y— change (i.e., "C" ' 
command arid the memor r dump * 1 . e. •* "Pi 1 * command ot MUbbUG. 


5.1. The Application of the Ore-1 ins Assembler / 
Disassembler in the " C " ComiT.and 


The original "C" command, which has one parameter, 
displays the .current hex value- of the contents of memory 
location START, and then it accepts a new herrval ue -to be- 
iriput into that location. The user can read his or her 


program in machine language and mod if - , the program b 


tvp x n <3 


hex values. After the One-line Assemb 1 er/Di sassemo 1 er- 
software packase is applied* the "C“ command* which still 
has one parameter* displays the current assemb 1 y-1 ansuase 
instruction that starts at memory location OTARI'. Tnen the 
"C" command accepts a new as semc-1 i— language instruction* 
assemb 1 es it to machine language* and puts the machine code 
into memory stai ring ar location S i AR'i . 

if the new assemb 1 v— 1 ansuase mstruc c ion is terminated 
bv a carriage return with no other termination character , 
the One- line Assemb 1 er t Oi sasserrib 1 er automatically continues 

the "C" command bv setting START START + (instruction 

length) and per forming the “C" command s function for the 
ne.^t instructi o n i n me rn o r . . T h a n o t a 1 1 o n "iinstructi o r, 
length)" as it is used here means the length of the new 


i n s t r 

u r t" 

i o n - 

not the 

1 e r i g t 

h o f t n a o Id l n s t f- u c 1 1 o 

u s e r 

do 

e s n 

t type a 

n e w 

ins tructi o n ■ n o we ve r * 

i > i s t r 

u c t 

3 on 

is used as 

r \ i s* 

n e w l n s t r u c 1 1 n n . 


If a comma terminator is used to terminate the new 
assemb 1 i— l anguase instruction tor location START* the One- 
line As sernb 1 er/Di sasserrib 1 er will keep the same value in the 
START parameter without... changing it. The.n- the-- One— 1 i ne 
Assemb 1 er/Bisassembl ar wil 1 perform— -tire — -command ' s 
function again for the same START location in memory. 


If an asterisk terminator is used to terminate 


the new 


assembly — lansuase instruction tor location START- the One-- 

line Assembler/Disassembler sets START < START - 

(previous instruction lensth) and automatically performs the 
"U" command's function with the preceding i ns true t ion in 


fTi’SITlC'P’T ■ 

The A 

ssembler / D l 

s as 

z cf ffi U 1 -c* 
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r err. err> he r s 
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Unst r« s «;« i* 

3.S manv 

as the 
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str 

u c 1 1 o n 
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that have 

be- 

i - n l n Put o r 

^ 3.iTf i n-cf d 

w i t h 

the cut r ' e ! f 

C 1 

r • v* o c *5 *r 

3.0 

n of tne 

ii r 

•_ O M«i7'€s M O a 

T h e u s a r 

can 

t h e r e f o r e u 


u j 

1 1 1 -e 

ll 

t e r m mat o r 

to 

sack up o'r 


as man .• as 20 instructions or to tne orismal START a d cress- 
whichever' occurs first. An attempt to back up beiond either 
limit causes the "C" command to sta. on the instruction at 
the limit. 


If the new assembl 1 ansuase 
br a period, the “C" command rstui* 
MUD BUG after it installs the 
assembl .-I ansuase instruction. 


instruction is terminated 
r. -s c •:> n t r o i t >*■ the t o p o f 
mac rune code of tne new 


/ 

Final r, , if a solidus ("/“) terminal- 
command is aborted and control returns at 
MUD BUG with no chanse to the contents o +- 
at START. 


r is used, the “ C " 
o n c e t o tne t o p o f 
c* c 5 X i o r» s s *c *3. r* "C i n =» 


If a termination character (CR <- , . or /) is input 

alone without a new assembl-i — language instruction, the 


contents of the memo rv locations remain unchanged? but the 
function of the termination character regarding the 
continuation or termination of the "C" command is still 
effective. MUD8UG uses the instruction length of the 
existing instruction in memory when the user doesn't type a 
new instruction. User* can therefore e. amine several 
consecutive instructions rather conveniently bv using 
car r 1 age- r e r ur n o r a st s r is!- terminators? a n d t tier nsec to 
type new assembl i— language instructions only when new 
as semb 1 v— 1 ansuas e instructions are actual In desired. 

The comma? period? asterisk? and solidus terminators 
are different from the carriage-return terminator. The user 
who f-iPes a comma? period? asterisk ? or solious terminator 
must still type a carriage return after the comma? period? 
asterisk? or solidus. When we refer to a carriage-return 
terminator? therefore? we ar-ai actual!. - referring to the lack 
of any special termination character immediately preceding 
the carriage return that a! wars terminates the input line to 
true One-line Assembler. 

The user c a n correct e . ■ t e n s i v \r t - . p i i .s e i ■ r o r s d **. t yp ins 
a backslash (“\") to rub out t he innr<? input line before 
the carriage return is typed to terminate the, i,n.put line to 

the One-line Assembler. Then the user-- -can type another 

assembly-language instruction right after the backslash 


character. However, the recommended procedure is . to tv Fe a 
backslash followed by a comma followed bv a carriage return 
before restarting the input line. 

The One— line As sernb ! er/Ui sas seme- i er n 1 1 cuj the user to 
correct t.pin^ errors bv using the backs 1 ash as many' times 
as desired. The user must type an entire new assembly- 
language instruction instead of typing par t of tr,-=- assemol 
language instruction atter the backslash is typed. Once tlie 
terminating carriage return is tv pea? no . : ur ther corrections 
can be n i a d e . 



The user who wishes to erase a tan character from -an 
input line is advised to use a backslash, to delete the 


entire input line instead of trying to use a backspace to 
delete the tab character. The One-line Assembler doesn't 
adjust the cursor position to account for the possible 
multi-column aspect of a tab character that is deleted-. and 
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also accepts a carriage r e t u r n when t h e 1 n p u c b u i* t* u r is full 
because a carriage return terminates the input line. 

5.2. Ths Application ut the One— line Assemnlsi / 

Disassembler in the “id" Command 

The original "Id" command requires two- parameters?- -and 
it dumps locations START through STOP in hexadecimal format 


[ 


40 


to the terminal. The memory dump actually starts uith the 
location whose address is FLOOR C STAR T / 1 6 J <- 1 6 , so the 
hexadecimal memory adaress of the first word of tne dump 
always ends in zero. The memory dump is printed with 16 
values per line ( e ' • c e p t possibl r for tne last line. which 
mav be shorter > , and it is f or mat re a for ease of 
readability. Also, the memo.*- . address of the «- i r s f value on 
the line is printed at the ossinrnns oi earn line. Ana r 
users see on the terminal are one machine cones of the 

i 

contents of locations START thr oust STOP r 

i 

! 

After tne One-line As semi.. 1 er 'Di s-a.5 seme. 1 er software 

paclase is applied in the " O " c emmanci-. the “M“ conunand still 
requires two parameters . and i* dutriFs locations 'if ART 

i 

through STOP in assemb I - I ansuase instruction format to the 
terminal . The memor . dump is printed with one assemb 1 v- 
l ; ari3uage instruction per line. and the memory address of 
each is seiTib i .—lane u as e i n s t r u c t i o r. is p r x n t e d at t n e 
beg i nn i ns o+* sacn line. if s TOP is i n the middle of an 

I 

mtruc tiom the "h" command prints the entire instruction 

I 

instead of truncating the instruction. Truncating the 
mstructi o n w o u I d c o n f use t h e u s e r . s o f n e real stopping 
location of the "M" command is STOP or STOP+i or- STOP+2 
•depending on the instruction length of the last instruction 
processed. Control returns directl-. to the top of MUDBUG 

i 

I 

i 

I 

i 


f\ 1 


after the assemb 1 v-1 ansuaee instructions from START through 
STOP are printed on the terminal. 


The output of the "M" command is illustrated bv the 
f o I 1 owins sample inemor ,• dump. 
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Chapter & 
Cone! us ion 


This report has discussed the internal routines of the ;: ' 
One— 1 ine Assembl er/Disassemo 1 er software package* the source 
syntax* expressions* and pseudo instructions of the One-line 
Assembler, the One-line Disassembler syntax, and 
applications of the One-line Assembl er/Di sassembl er to the 
existing functions of MUDBUC. 

The One-line Assembler/Disassembler software package 
has following restrictions** 

a. Labels and line numbers are not used. Labels are 
commonly used in assembly language to refer to 
other lines and locations in a program. The One- 
line Assembler has no knowledge of other program 
lines and therefore cannot make the required 
association between a label and the label 
definition located on a separate line. 


b. Source lines are not saved. In order to read back 
a program after it. has been entered, the machine 
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, -code 


is . d isas semb T &d j^an d the £s pVaved^as | 


mnemonics and - operands * 


Limited error indication 



4 3 

The One-line Assembler 
shows only one error messase* "INVALID: the whole 
input string"* to the user. In contrast* the cross 
assembler generates specific error messages for 
different types of errors. 


d. Onlv a few directives (pseudo instructions) are 
accepted . 


e. No conditional assembly is used. 


The One-line Assembler is a true subset of the 1 16:300 
cross assembler. The format and syntax that are used with 
the One-line Assembler are acceptable to the cross 
assembler. The One— 1 ine Assemb 1 er/Di sassemb 1 er- is a 
powerful tool for creating* . modifying* and debugging M6800 
c ode. 




